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Version 2.0 


The Resource Editor for the Mac™ OS Wizard 


ORDERING INFO 


Kequires System 7.0 or greater, 
L5MB liAM, CD ROM 

Standard price: $256 (decimal) 
Website price; $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PO's, or Visa/MC 
Taxes: Colorado custonners only 

Extras (call, fax, or email us): 

COD, FedEx, UPS BlueyRod, 

T n te riia iional Shi p ping 

MATliEMAlSTHETICS, INC. 

PC Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440^0504 
resorcerer@math e m aesth etics. com 


• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 
» New Apple^rtpt Dictionary (*aete’) Apprentice Editor 

• Mac OS 8 Appearance Manager-savvy Control Editor 

• PowcrPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; it’s easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opena/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Eez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• llot-Hnking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bil List Mgr can open and edit very large data structures 

• 3Vmplates can pro- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, (JX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, letb's, lists and popups, even create C source code 

• Integrated single-window Hex/Codc Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

■ Relied on by thousands of Macintosh developers around the world 


Tb order by credit curd, or to get the latest newSt bug fixes, updates, and apprentices, visit our website^. 

www.mathemaesthetics.com 
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by Eric Guncintm 


A Call tor a More Open Mac OS 

In recent years, most Miicintosh developers have Intjked to 
Apple to provide the innovation of ihc Macintosh platform. We 
had no t:lioice. To cliange tlie look and feel of main components 
of the operating system meant unreliable, system-wide patt'hes, 
and these left the developer to the whim of Apple engineers who 
changed the underlying data structures, on wliich the developer's 
patches relied, just because they could. This is a tough area to 
make a business, hut some developers still stuerk it out 
Nonetheless, there are fewer such products available today, and 
they generally receive the blame l:>efore anything else for 
unexi>ected system behavior, rightly or wrongly. 

It seems clear that the new Apple no longer has the re,sources 
to be as innovative as they t>nce were; we developers have to do 
more t)f it t)urselves. However, Apple can still help; they c'an start 
0 {:)ening the OS to make it easier for third party developers to 
replace complete components for the entire system, 

Ret^ently, Apple has been devcltjping supiiorl for multiple 
iliemes to provide the user with choices for the overall look and 
feel of the Mac interface, 1 just hope they go far enough. This 
technology can allow independent developcTs to produce 
alternative interlace litemes. We can have a Windows 95 tlieme to 
help the Mac l>etter fit in Wintel envitonments. We can btve a 
cartoon theme for the kids. Novices can have themes making it 
easier to learn their way annind a computer. Expe^rt uscui can have 
themes which allow tJiem \o l)e inoie pnxluitive, liecause Apple 
{hopefully) Is clearly defining tlie API between the various 
components of themes, we developers tan easily explore new 
interface techn<jlogles without the risk <jf unreliable syslan [)atches. 

If Apple opens the system enough, and in the right 
places, we can fix their mistakes (like the gray menus and 
window backgrounds of the Mac: OS 8 Finder) and we can try 
out new things. In fact, Vd very much like to see a stronger 
.separation between the Finder and the general operation of 
the operating system, (After all, the Finder is just another 
application, isn't it?) There are great opportunities to provide 
ahernaLive,s to the Finder. Some people want a Finder 
alternative that takes less KAM, and they are willing to give 
up features to get it, Fd like a Finder that makes better use of 
sound and mcjtitm to enhance productivity. 

Does anyone remember Sonic Finder and Motion Finder 
of the late 1980s? Sonic Finder provided audible feedback to 
various Finder activities such as copying, moving and inishing 
file.s. Motion Finder allowed icons and window^s to be thrown 
across the screen. Instead of dragging an icon from the upper 
left corner of a 20 inch display ro the trash in the lower right 
corner, a simple flick of Uie wrist was enough to send the 
icon sailing in the direction of the Trash. If my aim was good 
enough, the icon made it in, and the file was deleted. There 


was even a version tiiat combined these features. These tools 
were developed as explorations in alternative interfaces. 
Apple probably abandoned them because they would not 
work for a majority of users. Unfortunately, those of us on the 
fringe were abandoned in the process. 

Now, if only Apple would open up the OS enough that we 
developers could plug in our own alternative interfaces, then we 
could again see stjmc real innovation on the Macintosh. 

Navlgatioii Services, an Open I>csign? 

One example of Apple moving in the right direction is 
their Navigation Services technology. This wfill be a 
repkeement for the Standard File package we have all come to 
love and hate. Navigation Services will provide a new file 
system navigation interface for all applications that use it. It is 
supposed to provide a variety of hcxjks for developers to 
enhance its capabilities, 1 am hoping that with this new- 
technology, Apple also allows developers to write complete 
replacements of the Navigation Services libraries. Apple is 
gtjing to the trouble to define the AFI between Navigation 
Services and all applications and the API to the fife system, 
Apple also should be open enough to let us developers 
completely replace the Navigatitm Services with our own 
version if we think we have a better idea how to implement it, 

Tliere are many similar opportunities for Apple to istdate 
collections of ai pa hi lilies into ,separaie libraries, encourage 
application developers to make use of l!ie new libraries, and 
allow users to replace those libraries with alternatives written by 
other developers, Cfext Services shtnild be foremost on 
everyone’s mind.) This approach to system software 
development is similar, in pruiciple, to the component namre of 
0]:)enDoc. Rather than have all OS operations dictated by Apple, 
users could choose to replace Applets .sumdard behaviors with 
alternatives that Ijeiter ,suiL their needs. 

Now, I don't advocate that Apple try to turn the Mac OS 
into another OpertDoc. I'liere are a variety of factors that 
contributed to the demise of OpenDoc, Imt there also were 
Sterne wortliwhile features of that technology. We should not 
throw them all away simply because OpenDoc failed. As long 
as Apple sticks with their current policy of improving die OS 
incrementally, they will ,successfully avoid the single biggest 
reason for the failure of OpenDrKr, QuickDraw GX, PowerTalk 
and others, Apple has to ease us into using tlie new 
technologies one step at a time, and as the hardware advances 
to support them, that the size of the OS doubles with every 
release, rather than dump so mucli on us at once. 

Most of all, I want Apple to open the entire OS to third party^ 
enhancements, but cleanly. Then I cun buy or write my own 
innovatioas if I don't like what Apple is supplying. K1 


Vll-WK)INJ 
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MacHASP Packs 
More Into Less. 
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by Dave Mark 


Event-Based Programming 



How a Mac program communicates 
with the user 

Over Lhe kiM year or so, weVe gotten a lot of feed[>ack ahotit 
the direction in which you want tliis column to hc^ad. Some ftjlks 
want more coverage of Java, others FowerPlant and Rhapsody. 
But the biggest vote of all was a return, for a speih to the basics. 
When I first started tills column more than six years ago (For you 
old-timers, my son Daniel, who was lx)m in tliese pages, is now 
5-1/2), we pl()we<l a path for lieglnners, covering tlie basics of 
working witli the Mac: Toolbox. Since then, weVe explored a 
wide variety of topics and !iavc covered a lot of ground. 

Over the next few months, weVe going to revisit some of 
that territory at the behest of a new generation of Mac 
progmrnnicr. We started with Iasi month’s column, which gave an 
updated answer to the question, "Mow do I get started vvilh Mac 
programming?” This month, we ll revisit the concept of event- 
based programming. 

Know someone interesLed in getting started with Mac 
programming? Hand them your co]>y of last rnomli’s MacTcch 
and pc^int them this way... 

EviiNl-BASIiD PRtKTRAMMIN<i 

Most the programs weVe created together have one thing in 
common. Each performs its main function, then sirs there waiting 
for a mouse click using this piece of code- 

while ( ! ButtonC) ) 


lliis chunk of code represents die only mechanism the trser 
has lo c:ommunicate with the program, In other words, the only 
way a user can talk it) one of our programs is to dick the mouse 
to make the program disappear! Tliis nionth',s program is going 
to change all that. 

One of the most imporUmt parts of the Macintosh 'l‘oollx>x is 
the Event Manager. The Event Manager tracks all user at:Lions, 
translating these actions into a form that’s perfeci for your 
pnrgram. Each action is packaged into an event record and e.ach 
event record is placed on die end of liie applic'ation’s event queue. 


For example, when die u.ser presses the mouse button, a 
mouseDown event record is tteated. The record describes the 
mouseDown in detail, including such information as the location, 
in screen coordinates, of the mouse when the dick occurred, and 
the time of die event, in ticks (60ths of a second) since system 
startup. When the user releases the mouse button, a second 
event, called a mouseUp event is queued. 

If the user presses a key, a keyDown event is queued, 
providing all kinds of iniormation describing die key that was 
pressed. An autoKey event is <|ueiietl when a key is held down 
longer dian a pre-speciOed autoKey direshold. 

Ihough there are lots of different events, diis monili we'ie 
gtiing to focuis on four of them: mouseDown, mouseUp, keyDown, 
and autoKey. Next monlh well look at some of the others. 

Working Wira Events 

Events are the lifeline Ix'tween your user and your program. 
They lei your program know what your user is up to. 
l^rogramming with events requires a wliole new way of diiiikiiig. 
Lip LintiJ this point, our progmnts have been sequential. Initialize 
die Toollxix, load a WIND resource, show die window, draw in 
it, wait for a mouse click, then exit. 



Figure J. main utfiml Imf) JlinvcharL 


Event programming I'ollows a more iterative path. Check 
out the flowchart in Figure 1. From now on, our programs will 
look like this. First, weT perform our program’s initialization, 
Tliis LJicludes initializing die Toolbox, loading any needed 
resources, perhaps even opening a window or two. Once 
initialized, your program will enter the main event kxip. 


6 


Getting Stakted 


MacTech • January 199K 


























The Main Event Loop 

In ihe main event loop, your program uses a Toollxjx 
function named WaitNextEvent() to retrieve the next event imm 
the event queue. Depending on the type of event retrieved, your 
program will respond accordingly. A mouseDown itiiglit lx; 
[passed to a routine that handles mouse clicks, for example. A 
keyDown might be passed to a text handling routine. At some 
point, some event will signal that the i>rogram slK>u]d exit. 
Typically, It will |■)e a keyDown with the key sequence 
cominand-Q, a mouseDown with the mouse on the Quit menu 
item, or as the result of a Quit event sent by another program like 
the Finder. If If it's not time to exit the program yet, your 
program goes hac:k to the top of tlie event loop and retrieves 
another event, .starting the process all over again. 

WaitHextEvsnt(} rettirns an event In the form of on 
EventKecprd 

sttucL EventllecOld 

( 

short what: 
long Kfeasage; 
long when: 

Point where: 
short modifiers; 
h 


The what field tells you what kind of event was returned. As 
I said before, this month we’ll only look at mouseDown, mouseUp, 
keyDownj and autoKey events, though there are lots more. 
Depending on the value of the what field, the message field 
contains four bytes of descriptive infonnation. when tells you 
when the event occurred, and where tells yc3u where the mouse 
was when the event occurred. Finally, the modifiers field tells you 
the state of llie control, option, command and shift modifier keys 
when the event oeeurred. 

EventMaster 

Tills mcjndi's program, EventMaster, displays four lines, one for 
each of die events we’ve covered so far. As EventMaster f>nx:esses 
an event, ii higlilights that line. For example, Figure 2 sliows 
EventMaster immediately after it pixx:essed a mouseDown ewent. 


New UJindoiii 


mouseup 


keyDovn 


^toK^g 


Figure Z EventMaster in action. 


EveniMasier retpiires a single resource of type WIND. Create 
a folder called EventMaster in your Development folder. Next, 
open ResEdit and create a new resource file named 
EveniMaster.fsrt' inside the EventMaster folder. 


' Utito H * 121 fraw 


laHannnnPHirjiJ 

1 I 4 niH mil RHiHUIxi UiBIlilkU 

r«t«r: ^aariikiii 
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Figure 5 77ye WIND resource specijications. 

Create a new WIND resource according to tlie sfxrcs shown 
in Figure 3. Make sure the resource ID is set to 128 and the 
Close Box checkbox is checked. Select Set ‘WIND' 
Characteristics from die WIND menu and set the window title to 
EventMaster. Quit ResEdit, saving your changes. 

Rlnmnc; Even'i Master 

Launch CodeWarrior and create a new project t>ased on 
the MacOS:C/C++:Basic Toolbox 68k stationary. Turn off the 
Create Folder check box. Name the project EventMaster.mcp 
and place it in your EventMaster folder. Remove SillyBalLs.c 
and SillyBalIs.rsrc from the project; we will not he using 
these fiie.s. From the Finder, drag and drop your 
EventMastcr.rsrc file inio the project windowc You also can 
remove the ANSI Libraries group from the project, because 
we won't need them, either. Your project window should 
look something like Figure 4. 



Basic T oolbcx e0k 
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m 
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Data i 
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Figure 4 EveniMasier fmjfeci tmtdaw. 
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Evrniljoop 


V 


Select New from the File menu and type ihLs ,SQurcc code 
in the window that appears: 

^include <Soiiiid<h> 




void EventLoop C void ) 
I 

K V en tKec t> rd event ; 


iifdofine kBaseReelD 
(define kHoveToFrotit 
^define kSleep 

#definc kRowRelgl^t 
#define kFontSlze 

Jl^deflne kHouseDovm 
(define kMousellp 

J define kXeyDown 
define kAiitoKey 

r Gl obals V 


128 

{WindowPtr)‘IL 
7 

\k 

9 

1 

2 

3 

4 


Boolean gDone: 

short gLastEvent * 0: 


t Fimaiuns 7 


void ToolBoxInltt void 

vold Wlndowlnltt void ): 

void EventLogpC void ); 

voidDoEventi EventRecord •eventPtr )i 

void RandleKouseDown( EventRecord 'eventPtr ); 

void DrawContents f void ): 

void SelectEvent{ ahort eventType }' 

void DrnwFramc C short eventType ): 


gDone - falseI 

while ( gDone = false ) 

I 

if { WaitKextEvflntC everyEvent, &ovent, kSleep, nil ) ) 
DoEvent( &€vent ); 

I 


.i.iM i i >«, i» . I »DoRvent **»*»**/ 

voidDoEvent( EventRetord * event Ft r ) 

1 

switch ( eventptr'>what ) 
t 

ease monseDowni 

SeloctEvetit( kMouseDown ): 

HandleMouseDown £ eventFtr ): 

break: 

case EJOUseUp: 

SelectEvent £ kKooseUp ): 
break: 

case keyDown: 

Selectivenlt kKeyDown ): 
break; 

case autoKey: 

SelectEventC kActoKey ); 
break; 

case updateEvt: 

BeginUpdateC (WindovFtrleventPtr-^message ): 
DrawContentsC); 

EndUpdateC (WindowPtr)eventPtr'^raessage 3: 

I 

I 


r 


main * ****/ 


* HandlcMoascDtJwn 


vciid 0 »aiii{ void ) 


void HandleHouseCawn ( Kvent Record * eventPtr 3 


ToolBostlnll (3: 
Ulzidowinll (); 


WindowPtr window: 
short thePart: 


EventLoopC3: 
I 


LheFart = Flnd¥!ndow£ eventPtr->vhere* ^window ); 


void ToolBoxInit t void 3 
( 

InltCraft &tbePott ): 
InitFontaO : 
InitWindowsO : 

ThItMenufi C3: 

TEInilf): 

InliPialogsC nil 3; 
InitCursorO s 


if [ thePart ^ inCoAwny 3 
gDone = true; 

» 

DniwCimicnts ««*-"/ 
void DrawCoDtents( void 3 

t 

short i; 

WindowPtr window: 

window " FrontWindowO; 


i^indoi^lnii ********•/ 

void Windowing t( void ) 

\ 

WindowPtr window: 


for ( 1”1; 1<™3: i+i ) 

( 

MoveToC D. (kRowdelght *13 1 ): 

LineTo£ wlndow->portRect*right, 
fkRowBeight * i3 - 1 ); 


window - GetNewWindowC KBaseReslD* nil, kMoveToFront ); 

if ( window “ nil 3 
I 

SysBeepf 10 )i T t^Juldo t load theWlEW V 

ExitToEheliO; 

I 

SetPort( wi ndow 3: 

Te)«tSi7.e£ kFontSiae 3: 

EhowWindow( window ]; 


HoveTol 4* 5 ); 

Drawstring t '*\pinouscDown“ ]: 

KoveToC 4, 0 + kRowHeight 3: 
DrawStrlngt **\pinouselfp’' ); 

KoveTot 4. 9 + kRowHeight*2 3: 
DrawStringt 'ApkeyDown" ); 

HoveToC 4. 9 + kRowHeight*3 3: 
Drawstring ( “\pautoKey'* ): 
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The NEW BBEdit 4.5! 


It.Doesn’t Suck. 


There has never been a 
better time to buy 
BBEdit. 

Upgrade from BBEdit Lite, 
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Symantec C++ or a number 
of other products for j ust $79. 

This offer is available direct 
from Bare Bones Software, Inc. 

To order, call us at (617) 778-3100 
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If ( gLaslEvent I" 0 ) 

D r itwFr u(nn ( gl>fl r Kvent ) ; 
f 

.... JiticctEvcm *******^/ 

void SeleetF*vent( short eventType ) 

1 

Rect r: 

WindowFtr window: 

window ” FrontWindowO ; 
r “ window->portRect : 

if { gLa^lKvent != ) 

foreColori whiteColor ): 
Di:awFrame( gLajiiEvent )t 
ForeColor( blackColor ): 


DiawFraine [ eventType ); 
gLastEvent = eveiiLTypO; 

1 


/«*«******************-“".. DmwFmmt: ***^7 

void DrawFrame( short eventType ) 

1 

Rect r; 

WindowPtr window; 

window = FtontWindowO i 
r ^ window >pctrLKeeI; 

r,top ■= kRowHeight * (eventType 1): 
r,bottom r.top + kRowHeight 1; 

FruiiieRectt fir ): 

1 

Once the stHirce cckIc iji ty^xxl in, save the file* as 
r.vcntMasicrx’. Seieci Add Window horn the Project menu to add 
EveniMastenc to the project. Select Run from the Project menu 
to am EventMasten 

When tile HveiuMasier window apixars, dtcli the mouse in the 
window. 'Ilie mouseOown line will hi^tlilighi. Wlu;n you let of the 
mouse button, tlie mouselip line will iiiglilifthi. Try diis a few times, 
till you c:an play the entire daiin mio to 'WipeouE’ on your mouse. 

Next, pre-ss a key or two on your keylx^ard Clry^ any key exce[>t 
(jue of the mcKlUiei- keys control, option, sluft or coiinnand). d'he 
keyDown line will lift^ltli^Hh. Now prt'ss the key and hold it down 
tor a while. After a brief delay, the autoKey line will 1 1 1^1 1 light. 

Once you’re done playing, click the mouse in the 
EventMa.ster window’s close Ikix la exit the jxogram. 

Walking Tuhdugh the EventMaster SotfRciE Cgdh 

EventMaster .starts off by including <Scjynd,s.h> to access the 
SysBeepO system call, (SysBeepO used by l>e part of OSUtils.h, 
l>ui Apple moved it to Sounds.h as pan of Universal Inieifaces 
3,0.1, iiicKieded with QxleWanior Pro 2.) Next we define a series 
of erjnstants. Some you know, some you don’t, 'ilie new ones 
will be explained as they are used in the code. 

#d^tlnt£ kJl;i:jcRc^TlJ 12S 

ifidef ine kMoveTuFrun l (Wind owPtr) - IL 


kSleep J 

#doflnG kRowHelght 14 

^define kFontSize 9 

//define kJ^ouseDown 1 

//d&fine kMousaUp 2 

//define kKeyDown 3 

j/define kAutoKey 4 


'Hie glolxal gDone starts off with a value of false. WJien the 
iiiouse is cUcked in the window's <::lo,se Ik)x, gDone wall be set to 
tru 0 and the program will exit. gLastEvent keeps track of the last 
event that tx'cuiTed, taking on a value of either kMouseDown, 
kMouseUp, kKeyDown, or kAutoKey. We do this so we can erase 
die old highlighting (if^ any) before we draw^ llie new highlighting. 

Boolean gDone: 

fshort gLastEvent ^ 0; 


As usual, our program includes a function prototype for all 
our functions. 

r I'liiunions V 

void ToolBoxlnit ( void ): 

void WlndowTnlt( void ): 

void EveniLoop( void ): 

void BoEvent t EvenrRocorcE *eventPtr }; 

void HandleMoujseDowilt EvcntRecord 'eventFtr ): 

void DrawCoiitents( void }; 

void SeleotEvent( short eventType ) : 

void DrawFtame( short eventType ): 

matn() starts by initializing the 'Foolbox and loading the 
WIND resource to build the EventMaster w^indow. 

muin 

void ttialn( void ) 

t 

ToolBoxlnit [): 

Windowinit0: 

Next, we enter the main event loop. 

RvFhntLoop 0 : 

I 

EventLoopO continuously loops on a call tc) WaitNextEvent(), 
waiting for sometliing to set gDone to true, d’lie first parameter to 
WaitNextEventO tells you what kind of events you are interested 
In receiving. The constant every Event asks the .system to send 
every event it handles. 

dlie second panimeter is a pointer to an EventRecord. The 
rliird pa 1:1 meter telLs the system how friendly yoiif application is 
io other applications running at the same rime. Basically, the 
number tells the system flow many Licks you are willing to wait 
be) ore recieving the next event, allowing other applications to 
gel some (>roce,ssing time. This number should be alxmt 7 when 
tlic ut3]3lication is not busy with a pttx.Gssor intensive task. If the 
applic-ation were doing .something where it needed as much 
processor Lime as ^x^ssible (such as compressing a document), 
this value would be set to zero, btii WaitNextEventO would be 
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chilled once every jjeven ticks to give time to the system to check 
other applications. 

The last parameter specifies a lionic-l>asc region for tl^e mouse. 
If the mouse niovas outside tliis region, the system will generate a 
special event, known as a mouse-moved event. Since we won’t be 
handling mouse-moved events, wc’ll pass nil as tills last paramcten 

void EventLoop t void } 
f 

EventRecord events 

^Done = false: 

while ( gDone false } 

1 


WaitNextEventO will return tme if it successfully retrieved an 
eveni from the event queue. In that case, well process the event 
by passing it to DoEvent(). 

If ( WaltNextEven l( everyEvent» fitevent, kSleep, nil ) ) 

13 0 Event ( fifevent ): 

] 

1 


WaitNextEventO described in detail in Inside Macintosb: 
Macintosh Toolbox Essentials, on page 2-85. If you get a chance, 
read chapter 2, which desc:ribes the Event Manager in detail. You 
miglit also want to refer to Chapter 4 in the 2nd edition of the 
Macintosh C Progiamniiag Primer 

DoEventO switches on eventPlr->vhat, sending the 
appropriate constant to the routine SelectEvent(}, which 
highlights the appropriate line in the EvenlMaster window. 

DoEvrni 

void DoEvent( EventRecord 'eventPtr ) 

I 

fjwitch ( evetitPtt-)what ) 

( 


In the case of a mouseDown, we also pass the event (in to 
our HandleMouseDownO routine, which will check for a 
mouseDown in the window's close box, 

case mouseDown: 

SelectEvent( kHouseDown ): 

Handlf^MoiiseDownC eventPtt ): 
break: 

case laouseUp: 

SelectEvent( kWouseUp ): 
break: 

case keyDown: 

SelectEventC kKeyDown }; 
break: 

case autoKey: 

SelectEverjt( kAutoKey ) : 
break; 

OK, 1 know I promised we were only going to handle four 
event types this month, but 1 couldn’t help but sneak this one in 
here. An update event is generated by the system when the 
contents of your window need to be redrawn. Well get to 
updateEvt next month. In the meantime, if you want to force this 
code to execute, tiy^ triggering your screen dimmer, or cover die 
EventMaster window widi anodier window and then uncover it.. 


case tipclateEvL: 

BeginUpdattiC (WindowFtr) eventftr->inesaast:i ): 
DrawContentsO: 

EndUpdate( (WindovPtr)eventPtr->inessaga }; 



HandleMouseDownO calls FindWindow() to find out in which 
window, and in whic:h pan of the window, the moiLse was clicked. 

void HandleMoUS©Down( EventRecord ‘eventPtr ) 

I 

WindowPtr window; 
short thePart: 

thePart ^ PindWindow( eventPtr->where, (iwindow ): 

If the mouse was clicked in the close lx)x {abo known as 
the goaway box), set gDone to true, 

if ( thePart = InGoAvay ) 
gDone - true: 


DrawContentsO draws the contents of the EventMaster 
window. Notice that the high lighting routine DrawFrame() is only 
called if a i>revious event has been liandlcd. 

void DrawGontents( void ) 

I 

short i; 

WindowPtr window: 

window = l-roritWindowf J; 

for [ i“i: 1 ++ ) 

I 

MoveTo( 0, (kRnwHeight " 1) 1 ): 

L1ticTo( window >pnrf Red . r!^ht. 

(kRowHeighl ‘ 1) 13: 

I 

HoveTq(4.9): 

DrawSttlngC "VpmouseDown*' ): 

MoveToC 4, 9 + kEowHpJBlrt ); 

DrawStriiig( "VpnujuacU p'’ ) ; 

HoveToC 4, 9 + kRowHeight*2 }: 

DrawStting( "\pkcYDown'' ); 

MovcTot 4 . 9 + kKowHfsjght ■ S ): 

13 raws t r i n g ( " \ pou t oKoy" ): 

if i gLastEvent 1= U J 
DrawFrame[ gLastEvent }: 

1 


SelectEventO erases the old highlighting (if it existed) and 
then draws the new highlighting. 

ScJcclEvoii 7 

V 01 d Selectlvcnt ( short evetitType ) 

[ 

Kect r: 

WindowPtr window; 

window ^ FrontWindowO : 
r = window->pQrtRect; 
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if ( gLasiEvcnt !" 0 ) 

I 

For^ColorC whiteColot ); 
DrawFrameC gLastEvent ); 
ForeColort blaekCcklor ); 
I 

OravFramat eventType ): 
gLaatEvt^tit “ tventTypa; 


DrawFrameO draws the highlighting rectangle. 


/****.UmwFimii! **** 

void DrawFrflraet short eventType ) 


Rect r: 

WltidowPtr window: 


7 


window = Froil tWindow(); 
r - wiDdov->portKoct; 

r.top ^ kRowHeight * (aventType - 1); 
r.bottom ” r.top + kRowfloight - i: 

FramoRoctf frr ): 

1 


Some Homework 

To understand more about events, read the Event 
Manager chapters in Inside Maciniosh: Maciniasb Toolbox 
Essentials. You may have noticed dial EventMaster left a lot of 
room on the right side of each of its event lines. Use this space 
as a scratch pad, drawing information culled from the 
EventRecord each time you pn)cess an event. 

^s an example, try vvrititig out the contenis of die when and 
where Helds, flow about pulling the character and key codes out 
of the message field of a keyDown event, llilnk of EventMaster 
as an evem playground. Play. l.earn. 

Next Month 

Next month, we’ll dig into some events designed 
specifically for tlie Window Manager: update and activate 
events. See you next month... D 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 
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Define your file format 

• Easy, familiar Cdike statements. 

• Complex formaE.s handled by powerful syntax. 

• Input is checked and compiled os you type. 

View, edit, or analyze your data. 

• Edit data directly in window. 

• Automatically check values, at your option. 

• File can be larger than RAM. 

Multiple uses: 

• Modify Finder Info and fUe parameters. 

• Also edit data in application heaps, 

memory handles, and parameter RAM. 

- View entire disk volumes. 


Quadrivio General Edit 

ADVANTAGES 


t/ Quick insight into data structure contents. 

✓ Easier than studying MPW’s dumpfilc output. 

✓ Faster debugging with dear display of data. 

✓ Saves coding time with direct data editing. 


NEW 


On-line version 


$195 


Start using General Edit just 30 minutes from now. 
Visit our web site. See, Learn, and Downlood. 


http://www.quadrivio.com 


Quadrivio Corporation into@quadrivio.com 
1563 Solano Avenue #360 Berkeley, CA 94707 (51 0)524-3246 
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Designing Appearance-sawy Applications 


Using Apple’s Mac OS 8 
Human Interface 
Guidelines and the 
Appearance Manager 


This was supposed to be a simple 
review of the Mac OS 8 Human Interface 
Guidelines, a Develoj>er Note from Apple. 
But, wMe trying to write the review^ \ 
ended up tracking down additional issues, 
such as what, exactly, the “Mac OS H 
Human Interface" refers to, what 
Appearance” means, how tlie Appearanc^e 
package updates the Control Manager and 
the Dialog Manager, and liow to go about 
using this infomiation in your design. 
Here's what I found. 


to create tliemes witliout liaving to piogmm them. Applications 
which call Tcx:)llx>x-staadard interface elements will automatically 
display these new inleifiice elements. This will allow users to 
CLLSiomize the kx)k of llicir desktops, without using extensioas or 
ch;inging any basic functionality. 

In the meantime, the mv^ Appearance Manager extends 
interface elements from tlie Window, Control, Dialog and Menu 
Managers. These finally bring Mac Toolbox support for new 
standard controls, including sliders, progress bars, digital 
clocks, disclosure triangles and tab panes, as well as menu key 
t:ommand icons and more. 

In a sinking instance of rationality and clarity, Apple will 
allow developers to ship this funaionality with their applioalions 
to run on earlier systems! Appearance 1.0.1, an 
extension/conirol panel package, is designed to work with 
versions of Mac OS from 7.1 through B O, and nms on 68K and 
PowerPC prexessors. You can use these Gestalt selectors to 
check for the Appearance Manager: 

r sdecior and vnJues for tlic Appcaranci,' Manager 7 


About the Mac OS 8 Human Intebfacb 
Mac OS 8 has some fairly radical 
changes from System 7 automatically 
propagated througliout all applications wliich 
call tlie standard T(x>Ilx}x. Tliese changes 
include a gray-scale Icxjk, windows widi 
draggable borders, button-I ike popup menus, 
new contKib such as piogress bars, an 
explicit I lelp menu, and more. All common 
interface elements are now grouped together 
under tlie lenii Appearance, a cTaicept 
salvaged from Apple’s Copland effort. 'Ibis 
Appearance concept will allow future Mac 
OS releases to support switcliable — 

unified sets of interface elenieuLs, including 
w'indows, cliatogs, controls and color. When 
themes are supported, designen^ will lx able 


enmn I 

gfifltaltAppearanceAttr ^ 'appr', 

gesLaltAppearanceRxists = fl, 

gestaliAppcacanccCcimpatMnde ” I 

): 

According to Apple^ the Appc^arance package supports tliree 
mn-time models: Classic 68K, CFM-68K, and PowerPC CFM. Color 
Quidd^mw is required for Appearance, so it requires a 68020 or 
Ixtter processor Yoli can download the ctiirenf Appearance 
package from Apple's developer site, as described Ixlow, 

About The Human Iivterface Guidllines 
Back to the de^sign issties and the guidelines: designing tlie user 
interface of an applituLion or ct)nlR)l panel is not Uivial. Designers, 
and es|iecial!y programmers working without formal design 
training, are often confronted with .sitUiJtions where lliey must 
present complex infonnation without confusing Ixginners or 
annoying cxfxn Lisers. Apple lias traditionally provided advice and 


Avi Rappoport <avirr@wei!.coni> is interested in user experience design {combining interface and fundionalily), particularly 
for information retrieval applications. She is a veteran of StarNine, Metrowerk.s and Niles ^ Asscx:iates. 
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Want more from your Mac? 


AU'l'OMATbi 
OFTEN-REPBATED 
TASKS. 


Integrate 

MULTIPLE 

APPLICATIONS. 



Raptldly build 

APPLICATIONS & 
PKOTO’ITPES. 


Customize 
QuarkXPress ^ & 
FILEMAKER'*' PrO. 


Personalize 

YOUR COMPUTING 
ENVIRONMENT. 


FaceSpan'“ 3.0 is a cutting edge interface design and 
rapid application development (RAD) tool which gives 
you the power to build and customize scriplable 
Macintosh applications quickly and easily, 

FaceSpan is used in conjunction with AppleScript™ 
or any other OSA (Open Scripting Architecture) 
language and takes the place of Visual Basic^ on the 
Macintosh. 


'TaceSpan is one of the most wonderful pieces 
of software I have ever seen/' 

Howard Oakley, Personal Computer World 

"No scripter's workshop should be 
without FaceSpan/' 

Tim Warner, 4 Stars, MacWorld 


Features new to FaceSpan 3,0 give you: 


Transform the way you work today with FaceSpan! 


• M^cOS 8 Appearance Manager Supporl - Your FaceSpan 
applications can now include hierarchical menus, tab 
panels, disclosure triangles, bevel buttons and other 
MacOS 8 interface objects. FaceSpan 3,0 applications 
are also compatible with MacOS 8 themes when they 
become availabie, 

• Improved Performance - Your FaceSpan 3,0 applications 
launch much faster as scripts attached to windows and 
window items are loaded only when needed, 

• Enhanced Menu Editor - The FaceSpan menu editor 
now allows you to setup submenus and assign com¬ 
mand key modifiers directly. 


1-800-322-3772 (USA Only) 
1-801-226-2984 
1-801-226-8438 (Fax) 
facespan@dtintxom (E-mail) 

http://www.facespan.com 



Fo<*e5pai1. is a trailL'niiiTk ml Olpltnl IntumaUorutL All iiCher trpdcnwK't M thiir jr^spetlivi? iBuidcrsv 



















dtisi^ infonnaiion in tlie Human Interface Guidelines, lliis lias 
helped interface designers to he consistent in iheir standard 
elements and to create good solutions for situations s[>edfic to 
applications. The Mac OS 8 Human Interface GuideHnes continue 
tills tradition, describing the changed elements and new features in 
Mac OS 8, and how to incorporate them in your interlace. However, 
these Guidelines do not include liackground materials on the 
theories and principles of interface design: for these, see the earlier 
Macintosh llmmn Interface Guidelines. 

Showing that Apple "geLs \C about web distribution, both 
the original Human Interface Guidelines and this update 
(among other documentation) are available free on the Web, 
in both HTML and Adobe Acrobat PDF format at 
<http://d€vworld.apple,com/dev/insidemac.shtml>. 

Tlie Mac OS 8 Human Interface Guidelines is aimed at 
people designing and implementing interfaces for applications 
and control panels, so they can make best use of the new 
features. It includes such specific guidelines as detailed pixel 
counts of distances between radio buttons, and suggestions for 
when to use a scrollbar instead of a slider. The writing is clear 
and concise, and the examples are good — of the high quality 
wc*ve come to expect from the Inside Macintosh series. 

Unfortunately, the reasons for changes in Mac OS 8, such 
as the removal of the bcirder around dialogs, the new text “Help"' 
menu, changes to the scrollbar arrows and the “affordance" 
(cursor change to indicate move, copy, alias, etcj are not 
described at all, Past versions of the interface guidelines 
explained more of the theory behind design decisions, which 
educated interface designers and helped them when they had to 
create elements not covered by the standard interface. In 
addition, this book does not provide much to help designers use 
contextual menus or extended menu key commands. 

Therefore, this dtHaimenl Ls only adequate: it provides the 
basics but does not go beyond. It does nor give enough 
l^ackgroLind, theory and examples to ensure that Mac designers 
create programs with consi.sienL and appn>[)riate use of new 
interface elernenis, and tliat's a shame. 

WiiAT Is IN HIE Book 

The Mac OS 8 Human Interface Gtiidelhm covers Controls, 
Dialog Boxes, Menus, Windows, and Control Panels, f m going 
to descril^ it very briefly, as all interhice designers and most 
prognimmers should just get a copy and read it theiiLselves! 

Old Controls Updated 

'Ihe Control Guidelines chapter ilescribe.s the c:hanges to the 
old controls: push huilons, radio buttoas, jxipup menus, list 
lx)xes, scrolllrars, edit text fields and static text fields. Ibey have 
all Ix'en updated to a more three-dimensional, *‘m<xlern" Itnik: 


Q Double-click title bar to collapse 

figure L Neu^ Checkbox Control. 


The c:hapier descnlx-'s new features, such as "mixed states'* 
for radio buttons and checkboxes (for situations when the 
selection includes multiple states, such as text with several fonts). 

H ^ Control Panels 

Figure 2 Mixed State Checkbox 
(with Disclosure Triangle on the left). 

One of the nice changes is the new disabled states for seleaed 
radio butttins and dieckboxes, wliich fixes one of my pet peeves 
witlt tlie classic look. Theie's no longer a big black bullet or X in tlic 
selected control: tlie selection indicators are now dimmed as well. 

In addition, the text of this chapter has l>een updated using 
examples from tlie real world. My favorite: 

Avoid the use of n^ative labels. A checkh(}x labeled "Delete 
read tnessages** mib a default state of off is a clearer choice than 
a checkbox labeled ''Do not delete read messag^^''defaulting to on. 

List Boxes now have built-in arrow key support and focus 
rings, and there are other similar changes tliat will make all 
programmers happy. 

New Controls 

In addition, the Control Guidelines chapcer covers die 
interface to new controls. These are elemenLs that are useful and 
helpful and were not included in the previous Control Manager. 

The controls are: 



□□□ 

□BQ 


Color 



Options 

Figure 3 . Bcwl Bullom. 


Keg Repeat_^_ 

Key Repeat Rate Delay Until Repeat 



t I I I 1 t I t t I 

Slow Fast Short Long Off 


Figure 4 Horizontal Sliders in a Primary Group Box 
ftbere^s also a Vetikal Slider control). 

. Status_ 

Click Stop to turn off file sharing. This prevents other 
users from accessi ng shared folders. 

Figure % Secrmdaij’ Group Box. 
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3:22:28 PM 

Figure 6. Digital Clock with Little Arrow's. 


^ Show Item Information 

Figure 7 Disclosure Triangle, 


[ siart/Stop \/flctiuityjM;oftitoi^ 


Figure 8. Tal)s (and User Panes to go with them/) 


Figure 9* Visml Separators (horizontal rule). 



Figure 10. Placard control, with the new Scrollbar Arrows 
a nd Resize Box. 

The new cxjntrol clefiniuon for scroll bars has a variation 
which supports live scrolling. With a System 7 scroll bar, tite user 
drags a ghost of the scroll box, and the value of the scroll bar 
changes when the user releases the moLise. Witli a live scroll bar, 
the whole st:n)ll box mtives, and the value changes as the user 
drags. You can see tliis lx:havicjr in the Mac OS 8 Finder 

As in the old version, you need a control action 
procedure to keep up with the changing value of a live scroll 
bar But walcli out: where the Lhuml) of an old-slyle scroll bar 
takes an action procedure with no parameters, a live scroll bar 
now uses the same action procedure as the other parts of the 
scroll bar, with parameters. 


m 

Figure 1L Help fcon. 

And there's more than we can show here. 

Dialog Sl WincU>w Appearance 

The Alert section of the Guidelines replaces the previous 
description ot alerts, with full explanation of which version to 
use and iiow they will appear. 

The Dialog Box Guidelines cover such new features as key 
navigation (using the Tab key to move among edit text fields), 
and the focus ring, now automatically drawn around the field 
wliicii will accept die kc^ystrokes. 



NetLuork Identity 

Owner Nsarw: RqppoiHO^; ^ ^ | 

Owner Password. | 

Oomputar NaftiC' Mag | 


Figure 12. Focus Ring Around Current Text Field. 


ITie Layout Guidelines provide complete direaions for 
designing standard spacing of the dialog box or window, text in 
controls, spacing between controls, and even the Help button. 
These details will allow interface designers to make clean, elegant 
layouts without having to guess at the proportions. Use them! 

The new standard Utility window is designed for palettes and 
odier jion-standatd windoids. It am have a top or side title area, 

Hiese sections do not describe much of the theory behind 
the changes in diese elements, but dicy have cxcellcnL detail 
for precise layout. 

Menus 

Tlie Guidelines finally provide the final word on the location 
of the Preferences menu item: at the bottom of the Edit menu, 
after a separator. It will be nice to have the Preferences in the 
same menu locaiionin ail new applications. 

In addition, the Appearance package provides a new 
standard way to accept and display Control, Shift and Option 
keys as command-key shortcuts. Use these calls instead of third- 
party MDEFs for lK\st display on future systems. However, diis 
guide does not define a set of standard meanings for these 
extended command keys. Lasing the opportunity to define tliese 
standards is a mistake: developers need rules ,so users can have 
cross-api>lication consistency. 

Contextual menus are another new feature of Mac OS 8, 
providing context-sensitive menus when the user holds down the 
Control key and dicks. This guide offers a good, l)ask: 
description of how they work, but provides none of the 
theoretical background or design criteria. 

Conlrol Panels 

Tins chapter provides new insights into the issues of 
Control Panel interfaces. It shows what the standard 
arrangements .should he, and gives guidelines and helpful hints 
on how lo deal with exceptions. New informahon on fonts, 
menus, and icons, along with expansion and contractions of a 
details area should help as well, 

Multi-Pane Windows 

in the context of Control Panels, the Guidelines discuss die tour 
.siantkinl way.s of tiisplaying multi-pane windows (using rhe new an<l 
heipiful user pane tcxjlbox control). They are Tab controls, Buttons, 
.Scrolling list of Icoas and Pojvup menus. Unfortunately, my favorite, 
die disdosure-triangle list used by the (YxleWarrior Pro 1 Fretetences 
Winckjw, Is not awered. The guide uses four versions of the 
Appearance control ixinel to show die stiengdis and weakiesses of 
each approach, and provides some suggestions on how to choose 
lietween diem. This is exaedy the kind of practioil advice that Apple 
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should be sharirii?, alLliougli it would be nice if they chose one of 
these ofXioas and used it consistently for the system control panels. 

Morl Aboltt Mac OS 8 Changes and the 
Appearance Manager 

'the new Guidelines do not cover some of the interface 
changes in Mac OS 8, and yt)u may Ix! wondering how they 
c’amc alxjui. Here are soiiie tidbits I picked up at the Developer 
Conference, and from conversations and discussions on the 
Apple HJ Developers mailing lisL These notes apply to die 
Platinum Afipcarance tmly; we won’t see the real implications of 
diese changes until the Appearance Manager supports multiple 
Themes, 

Why Modal Dialogs Lost Their Borders 

In System 7 and earlier, aU dialog boxes have thick gray and 
black 4-pixel borders, but normal windows have a ,simplc black 
line br>rdtT, one pixel on the left and top, two pixels on the 
Iroitom and right. Tliis changed in Mac OS B: now windows have 
the thick molded border and dialogs are almast torderless. 


Sai>p no] (tantel nT] 


■fhe border now- signals window draggability — users no 
kinger have to click the title i>ar to drag, they can drag anywhere. 
However, users c^an't drag modal dialogs, so they don't have 
Ixirders. Ifs logical but disconcerting, and there's nothing in the 
new guidelines that explains this. 

The Collapse Box 

The coilapse tax in window title liars shows the 
WindowShade functionality explicitly. 

Figuf^ 17. Collapse Box. 

(On right side of a mndow uiihout a close hoxj 

As most designers have figured out, invisible functions are 
rarely used or remembered — tliat’s a great part of the Mac's 
success. So, Apple had to create a way for users to know they 
could collapse a window; ihe collapse Ixix is liie result As for why 
tile zcxjin box moved from the outside right comer to leave room 
for the collapse Ixix: ""some whidom mil not bam a zmm hexx Inif 
the\^ Hill have a collapse hem We thought it um more inponant to 
keep the comistency heitt?mn unndom with and mthout la! zoom 
box (the collapse fxvc l?eing always at the same place) than hetii^een 
ivindom of different versiom of the operating systtm!" [—Amo 
Gourdol, on the Apple HI DevelofXfrs mailing lisll. 



Figure IS. System 7 Alert showing dialog with border 


0 

V«u up Wp Umui 


WiHH tiu Mck wrt i|eu UiinCtAo, inv^yt! Gm, iw^ 
vf'Tt Qciiitt to Not til 4 Vtr, Uih 





Figure /4 Mac OSS Alert showing honiertess diak^*. 



Figure 1% System 7 Window with thin borders. 



Figure 16. OSS Windowshounng thick borders. 


Active vs. Inactive States 

The new appearance shows more di,stinction between active 
elements and inaciive ones: “Dtre of the design goats of the 
grayscale apl}earance was to gim better definition for actim and 
inacthe states. Active objects are l>eveted and pusbabte' whereas 
inactim objects are flat, and blend in with the background.^ 
I—Arlo Rase, on the Apple HI DevelojK'rs mailing list! 

Popup Menu Changes 

Hither than a square pkic'ard with a suhlle shadow and a simple 
black down-arrow, popup menus now luuk more like buttons, 1 like 
tills Ixxause it tells die user "push me" rather than "look at me". 


System Font: | Chicago 


Figure IS. Neu^ Popup Menu Appearance. 

In future OS releases, Lliere will be a distinction between 
pop-up and pull-down menus. "The new pop-up menu bus the 
dual triangles because when you click on it, the content goes 
both abotfe and below the menu. Sure this may not mean 
much now, hut in an upcoming release, we plan on 
introducing a pull-down menu control, and we need to have 
a visual distinction between the 

'l\p-ups areforchai^ng stale... puUdmim arefor i^icecuting a 
c(mimand. Sime you netn^r imnt to obstruct the title of a puU-demm, 
the menu will ham to be anchored to the contn^, nuher than Jkfoiing 
aix)m it."* ^-Ario Rose, on the Apple HI Developeis mailing listl 
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Scroll Bar Arrow Changes 

The .scroll har arrows were changed to up and clown 
pointing triangles from gray arrows for ""aesthetic consistency 
with the visual appearance of the platinum UxikJ" [-Arlo Rose* on 
the Apple HI Developers mailing list! 

Help Menu changes 

Apple has done a laige nunilx^r of user lesis on the Help menu* 
and finally put the word Help after the last menu on the right for 
each application. *Our results consisimily show that people 
jitsl dUin t see it where it um. Most users thought that qt 4 estion mark 
meant that the clock timn I sttre tf the time am right. We trkxl all 
comhinatiorLs of location, symM, and the only one peofde got" 

was the imrd 'Help'at the end of the aj^tlication menu list, lhat and 
the ueuf stici^^ menu l^ehavior nutde for a much higher rale of 
discovery7 1—Arlo Rose, on the Apple Ill Developers inailing list! 

Cursor Affordances 

With Mac OS 8* the Fiiider has a new set of ctirsors* which 
provide user feedback on wfiat will happen when they let go of 
rhe mouse. For example, an arnjw trursor with a + (plus sign) 
indicates a copy, an arrow cursc:>r witli a small right-facing arrow 
indicates a move, and an anow cursor wiili a curved am>w 
indicates an alias. AlUiough the tiirsors are included in llic 
Appearance Manager resource file* there are no interface 
guidelines, or specific functions to enable this behavior 
automatically widiin your application. 

WRiTiNci Appearance-Savw^ Afps 

To write Appearance-sawy applications, you'll have to avoid 
nonstandard CDEFs and WDEFs. Mast of the old control calls will 
automatically l:>e routed through tlic new c(>ntnol manager in the 
Appearance package, so tliey will look good even with the new 
Themes, But any additional t:onrrols or window types, such as the 
Grey Council, will appear as iliey do in System 7, rather than 
participating in the systemwide api^earance. 

1he guidelines, however, are not enough. Youll need some 
of the following tools and sources of information to get started: 

• Tlie best material so far on the Appearance Manager is by 
Edward Voas: "Appearance: Not Just Another Prcaiy 
Interface”, develop in MacTech Magazine, 13:5 {May, 1997), 
pp. 80-93. It c:ovefS IxJth the interface and programming 
issues, such as the new embedding hierarchy* how u> 
implement live scrolling, and hit testing, and it's incredibly 
useful! An example application demonstrating the 
Appearance changes is available on the MacTech wehsiie at 
<ftp://ftp.maclechxom/src/13.05/Appearance.sit>. 

• Tlie Mac OS Toolbox Reference covers the uxilhox ciills for 
the Appearance Manager. To download, go to 
<hnp://devworld.apple.com/dev/insidemac.shtml> and follow the 
links to the file, 

• The Apple HI Developers mailing list provides a chance to ask 
questions and clarify issues as a group, often witli helpful 
feedback from Apple employees. You on subscribe through tlie 


web page at <http7/www.lists.app[exom/apple’hi-developers. htrTil>, and 
amhives are at <http://publicJists.apple,coni/lists/apple-hi-developers/>. 

Appearance Manager SDK 

To get tlie most current Appearimce Manager, with the 
newest features and bug nxes, download it from Apple’s 
I>evWorld site at <ftp://devworld.appte,com/MacOS8/>. 

Application Frameworks 

Melrowerks has announced that the Powerl^lant Application 
Framewtrrk version in CodeWarrior Pro 2 suf5[>oris most of the 
Ap|>earance features. It wraps both new and old OS calLs and 
directs them automatically according to the presence or absence 
of the Appearance package, so you can just use the classes and 
ignore the issue entirely. Please note tliat FowerPlant has not 
implemented Contextual Menus in the CodeWarrior Pro 2 
release* althotigh there arc already tliird-party shareware classes 
supponing these new features, Warning: if you've written to the 
old grayscale classes, you'll have to make some major cfianges to 
use the new Ap[X?arance classes instead. 

Apple's MacApp framework may lx: updated to supptjn the 
Apjx'arancc package* although the status is not clear right now. 
MacApp uses the AdLib interface library and licenses some of the 
Grey Council classes. Current information is at 
<http://devtools.app[e.coin/macapp/>. 

TCL (Think Class Library) for Symantec C++ seeiiis to Ixf in 
maintenance mode. 1 couldn’t find any information on support 
for the Appearance package ut <http://www.sym3ntecxom/>. 

Resource Editors 

ResEdiPs templates do not sup[x>n the new features added by 
ilie A[)pearance Manager* and there is no indication that Apple will 
ever do so. 

Resorcerer version 2 5U[>ports the new' controls and most of 
the other Appearance features. IPs available from 
<http://www.malhemaesthetEcs.com/>. 

Constructor for CcxlcWarrior Pro 2 will support most of llic 
new controLs and other Appearance features. For unsupported 
controls* you can just add an item* enter its attributes* and it will 
appear as a gray Ik)x in Constructor* but will draw correctly when 
you compile and run. 

COMCLUSION 

llie Appearance package contains welcome additions to tlie 
Mac interface and w'ill promote consistency across applicatioas 
as well as saving all developers a great deal of effoit. Tlie lack of 
tiieoretical information in the Mac OS 8 Human Interface 
Cuidetimfs is probably due to die new* leaner Apple. But Apple 
has been known for it's intelligent, intuitive user experient:e, and 
the only way to continue to offer consistency and quality to 
customers is to work with developers. To keep the edge in 
interface* as we go forward with the Mac OS and Rhapstxly. 
Apple must invest in Ixxti research and communicatioas. B 
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Contextual Menu Basics 


Adding Support for the 
new Mac OS 8 Contextual 
Menu API; even for 
applications running 
without Apple's 
Contextual Menu Manager 


A New OS, A New API, A New 

UXitCAL INTERI ACE 

'ilie original thougiu that went into the 
Macintosh design was “ease of use", 'lliis 
would \yc the computer for “the rest of us"" 
who were computer novices or worse. After 
awhile, novices !>ecorne ^xjwer users who 
warn c|tiickcr ways to do things they already 
know how to do. You can see this in ttte 
menus of the Macintosh. Tlie user has menu 
items that he can select with the mouse, hut 
he also has Command-key short cuts. You 
also can see it in drawing paleiics that allow 
simple ct>mniands, yet can be double 
clicked for more in depth configuration. 
The contextuiil menu feature inlixxluced 
with Mac OS 8 tronlinucs tliis idea. While 
holding down the Control key, a user can 
dick the mouse while above some 
information he warns to manipulate. Itie 
infomialion could lie selected text, a picture, 
some database tables or anything we 
traditionally think of as exportable data, A 


popup menu appears to provide him with all the commands related 
ro this data. Even if no data b selected, the user tan sec commands 
related to the window, doaiment or application. 

Contextual menus pnivide no new commands that are ntS 
already available, l?ailier it groups the commands in a tjuick table to 
be raid and selected. Instead of seleaing the data and tlien selecting 
the command, with one quick click, die user am see what can be* 
accomplish. Searching for familiar commands liecomes much easier 
(For example, “is Find undc*r Edit, View or Text?”) Even if the user 
knows exactly where the command is in the normal menu, a 
Cx>nirol“click on the selected ejata is faster. Power users will quickly 
adopt Contextual Menus to gel their work done 

Whenever Apple introduced a new “logicial interface^ they 
provide a new API to developers so that we can [irovide this new 
feature lu users. Luckily^ the API for contextual menu is very 
small and involves concepts simibr to those in the Drag Manager 
or even the Scraj) Manager, this article explains what a 
dcvckjper must know to simply add contextual menus to his 
application. As an additional beneht, the article wiH show how^ 
easily Contexiual-Menu-like features can lie added to an 
application runing an older version of Mac OS, where Apple has 
not provided the Contextual Menu Manager. 

Extensicin Modules 

Tltere is one exception to the idea tltai Contextual Menus 
should not provide amimands not listed anywhere else. On a 
PowerPC Mac with the Contextual Menu API installed, extension 
mcKlules can add additional functions. Tliesc cxxJe fragments must 
Ixr ijistalled in a special folder in Uie System Polder liefore startup, 
Ihey are then kxided and called whenever a contextual menu is 
created. By kxiking at the data selected (text, picture, file, folder 
or even no data), the extensions ciin add commiinds to the 
contextual menu, 'fhc'se plug-ins have only read access to the 
selectcxl data, .so they can not modily the data, f>ui they can return 


Steve Sheets lias lieen happily programming the Maciniush since 19R3, which makc^i him older than he wishes, but not as 
yoimg as he acts, lieing a native Californian, hi,s developer wanderings have led him to Northern Viiginhi, For thasc interested, 
his non “Computer interests involve liis family (wife & 2 daughters), Sodeiy for Creative Anachronism (Medieval Keenaetment) 
and Martial Arts (Fencing ik Tai Chi). He is currenily an independent developer, taking on any and all projects and on l>e 
reached hy sending nwil to <MageSTeve@AOLCom>. 
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results in the Clipl)oard or by sending un Apple event, I'he hasting 
appliouion need noi concern itself with an extension module; all 
of a plugdn's functions dre done without the aiiplinition's 
knowledge, llie Contextual Menu Extension Module API will lie 
explained in an upcoming anicle. Until then. ju,st be aware that it 
is available, l)ut only supported on PowerPC machines. 

Adding 0)mmands 

The key to detemiining what to put into a contextual menu 
is the einpliasis — contexinid menus. Ignore that tlie feature is 
a popup menu. Tliere are many locations to place commands, or 
allow short cuts to global .settings. The u.scr has selected some 
content, which he wants to mexlify. Add commands that are 
based on die content of what is clicked. In a drawing program, 
clicking drawing elements (circles, reel. lines) should show the 
commantls that affect the element (rotate, change line thickness, 
change color). In a word processor, commands that change the 
style of the text or the arrangement of the dcK'imient are good 
choices. Window commands can be available, even if the user 
clicks a jxirtion of the window dial has no daUi. Think twice 
before adding an application conaiiand. For example, Quil is a 
poor choice; it already has a short cut in die menu. The API 
provides a way for sub menus aL^) to Lie added to the tiontextual 
menu, if too many commands need to added, this Is a gcx>d 
way to subdivide the list. 

The API 

'lliere are only 3 new- calls in the Contextual Menu APT. In 
dicir easiest explatiaiion, the calls initialiidc die API, check if die 
contextual menu should Lippear, and display the Contexaial 
Menu. These functions should ix* called only if tlie API is 
installed on die Mae. Use Gestalt to cheek if this is the case. The 
gcstaltContexmalMenuPresenT bit of the ge.staltContextual- 
MenuAur Cestali attribute indicates if the Contextual Menu 
Manager is installed. 

If the Contextual Menu Manager is installed, call 
lnitContextualMenus(). This will register the application as a client 
of the Contextual Menu Manager, Tlie routine returns noErr (0) if 
die initialization succeeds. This check ik Initialization should occur 
immediaiely after the standard uxilbox inidaliztilion. 

Uniting 1 : Contextua]MentiFtia.€p 

Chect if MsimgcrAvaibhKif so tnii li 
long result: 

if (gGStaltContextiialMonuAttr* result) ^ noErr) 

g_havo_c:otitextual_ menus ’• BitTst (ia_reEult, 

11 - ge s t a 11 Co n tex i i*ii iHenu Pres ent) j 

else 

g_have_ccintexttjfll_inetius ^ false-: 
if tg_have contextual_njenus} 

g_have_cont Gxtual_aenus = (Tn i iContextualMenus () “noEr r) : 

To indicate lie wants the contextual mean, the user docs a 
special click on some selected data. For Mac OS 8, this is done 
by holding down the Control key while doing a standard mouse 
click. However, diere is no reason that in the fumre this special 


click could not lx? done some odier way (such as a right mouse 
click on a two-button mouse). For diis reason, the Contextual 
Menu Manager provides a call that checks if the special click is 
being done. IsShowContextualMenuClickO should he t^alled after 
the application is passed any non-NullF.vent event. The function 
is passed the event record and returns true if the special click 
occured. If the function returns false, die program should 
continue normally. 

listing 2; ContexnialMcnuFunxp 

ParsG Evem, checking if the event w 0)nk:xm:il Menu special dick. If so, call niytine 
t{> handle this 

a_flaa ^ WflitNextEvent(everyEveni. &g_record. 10. NULL): 
if (g hflve_contextual_ffietiijnj I 

// if Con textual Menus cvcni, 

if (IsSbowCnntGxtualNenuClickCig record)) ( 

// Handle ComexLuat Menus 

G ContextualNeTiu(g_tecord): 
a_flag * false: 

I 

I 

// Handle Noraial Events if flag true 

The most important routine of die Contextual Menu API is 
ContextualMenuSelectO, It should be called only when 
IsShowContextualMenuClickO has relumed true. Not only does this 
routine have several parameters, the application must do several 
preparation tasks before it can be called. 

Assuming the application knows which window was 
chosen, the application should chet:k if diis window' is the 
currently selected window. If it is not, ii should immediately 
made the airrent selected window, and redrawn. Next, if some 
content data was selected, some sort of visual feodlrack should 
be drawn to indicate this. Inverting, either the data or die outline 
of ihe data is a common method to show^ what was chosen. 

Next, a menu handle should be created and iaserted into the 
menu bar just as if the PopUpMenuSelect{) caU was going to be 
made. At this point, the various menu items can be added to the 
menu handle- Sul>memis also can be added. If the Contextual 
Menu API adcis any items to the list (Flelp or plug-ins), the 
Contextual Menu Manager will handle parsing these iteiiLS; your 
applic'ation need not worry about them. 

Now Qill ContextualMenuSelect(). Pass it die created menu 
handle, the point that was clicked (in global coordinates), a flag 
diat must always be set to false (originally intended to indicate if 
the clicked area has a Balkxjn Help item, but now reserved for 
Apple's use), die Help type needed, the Help string, a pointer to 
die Apple event descriptor handling die selected data (named 
inSeleclion), a pointer to a long integer (resultiag 
outUserSeleclionType to explain what Fuippened), and two 
ptiinters to short integers (resulting menu ID & menu item). 

The Help type parameter can one of three values: 
kCMMelpIiemNoHelp, kCMlIelpItemAppleGuide, 

kCMHelpltemOihcrHelp, If it is kCMHetpIlemNoHelp, dien diere 
is no help associated with this contextual menu. The Contextual 
Menu Manager will put the word "Help*" m the front of the menu, 
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bill di.sai)li.‘ it. If tlw parameter is kCMHelpIlcuiAppleGukle, ibe 
Contextual Menu Manager will put tlie name of the main Apjtle 
Guide file into the front of the menu, if the piiraineter is 
kCMHelpItemOtherllelp, the Contextual Menu Manager will put 
the name pas.sed in the Help string into the fnmt of the menu. 

If there is no .selected data (or if the application dtK\s not 
want to pavi the data out), ilie inSelection parameter can lx- 
NUI.L Otherwise, It should lx* a valid Apple event descriptor. 
After the ContextualMenuSelect() call, the application is 
responsible for dis]X)sing of this descriptor if needed. For simple 
data stmdures, tlie descriptor has a handle to llic data (lx it text 
or a picture) as well as the data type. Applications that su)>port 
scriptability can pass an object specifier pointing to the selected 
data as the descriptor. This allows .some Contextual Menu 
exien.sions to .send an Apple event back to the current 
a])plication to I'hange the selected data. Refer to Imide Mm: 
luterapplication Co/MniMw/ca/kiW for more infonnalion aiwut 
Apple event descTiptots and object specifiers. 

If the ContextualMenuSelectO call returns successfully, its 
result is noErr (0). In this case, ouiUscifietectionType will indicate 
what hapfxned. If the user fails to select a menu or a ptug-in, 
the constant kCMNolhingSelected is returned. If the user selected 
Show HalltKin Help, the Contexriial Menu Manager will handle 
this call, and ilie constant kShowBalloonSeletted is returned (the 
application should do noiliing). If the user selected the Help 
menu item. kCMShuwHelpSelected is returned. 'Ilie Application 
should call the appropriate code, Apple Guide or another help 


.system, to display the appropriate help window. If the user 
selet led a menu item, kCMMenultemSelecied us returned, and 
die menu ID & menu item are also returned. 

Before the application pantes ilie result, it should remove any 
hiliting it placed on the data. Tlie commands die user selected 
might change this data, .so inverting it later may give the wrong 
results, "fhe application should delete and dispose of tlie menu 
handle. lastly, if the Apple event descriptor was created using 
Apple event calls, it should lx disposed. Listing 3 shows an 
example of how to setup the ba.sic ContextualMenuSelectO call: 

Listing 3: ContextualMcnuFunxp 

Sample CnmextualMciiuSclcn call to handle eieaiiiig & displayinit menu. 

Ulnt32 a_type: 

Sint 1ft a_tiionu id: 

UInti6 a_iQcnu_lteHi; 

Boolean a_j3alloon available == falae; 

Str255 a_help_sir ^ *'\pContextualMcnuFim Help^": 

Hint32 a_help_type * kCMKelpIteaiOthtrHol p; 

AEDesc a_descr: 

AEDesc* a_descr_ptr = NUIX: 

// Orate Mciiki 

MenuHandle a_m(fnu .handle “ E'lcwMenuf25S, 
if (a_nieiiu_handlei t 
SetPort (a _wi nd ow_p r. r}; 

// If WttMlow not fhJnl most, brii^ U front and draw on it 
If [FrontWindowt) ?=a_wlndoTrf.ptr) t 
[)elEC tWindow(a_wlndovi_ptr}: 

G„Draw{n window.ptr): 

I 

// If Color Vfrtndow, lilllit pit iiifr {invt-n franit'J 

if {a„vindow_pttl^g_w{ndow.about) I 
SetRect (&g_t0Ct , U* 0^ 200, 200): 

PenModnCsrcXor): 

FrameKcci rect) : 

PenNormal(): 

I 


// Insert Menu into Menu lisi 

lasertHen^(a_ffle^ll3^lTldlo, 1) : 

// Ml ittm im m^m\ bast- on From Window 

G_CoiitextiialMeniJ.PiUta„inenu..h«ndle, a_wlndow_pt.r): 

// Mi Descriptor with Pic, if possiWt 

a descr_ptr ^ fta descr; 
a desct.descriptorType * typePict: 
a_deBcr,dataHandlc (Handle) g_pic_l: 

// CaU lo HancUt Popup 

OSStaiUS a status = CoiitojttualMenuSeiect{a^menu_handle, 
p_event record .where* available. 

a_help_type* a help_Btt, a.^desr.r ptr, fta_iype, 
{(a_roena_id ♦ ft.i raenii.iteMi): 

// Unhilitc 

if {a window_pti I’’g^,w{ndow_abgut) ( 

SetRect(&g_rect, 0, 0. 200. 200); 

PenHodE(sreXor): 

FrameRcct(ftg_rect): 

PenHurmal(): 

I 

// if call was ok, 

ir {a status=iio£tt) ( 

// [f noTiml item sidccLcil, handle ji 

if (a_type“kCHMeiml lofflSeletted) t 

G_Coni:p.xtualH&nu^ci lDn(a «enu_id, a^mnnu item, 
□_window_ptr): 

1 

// If help sdectcd.hartinc it 

else if (a_type”krHShovHelpS elec ted) I 
If (window_about) I 

ShowWindovCg_window about): 

SelectWiBdow(g_windf>w about): 

] 

I 

1 
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by PACE Anti-Piracy 

Trial ware. Demoware. liiiernet distribution. 
You know you need it. You know it has 
lo be QcxJbte and secure. And you don't 
want to write any more code, or give a 
percentage of your sales to one of those 
“service bureau” solutions, Sound familiar? 
Then take a look at the I nterLok Software 
Authorization system, 

InterLok provides ^software registration 
insurance” letting you turn finished 
applications into locked, time-liniited 
“irialware” in minutes -with no additional 
programming! Your software can then 
be distributed via any media (Internet, 
CD-itOM, diskette), used under demon¬ 
stration limits that you define, and 
remotely unlocked with a unique key 
that you issue. 

For the most flexible, st cure, m i 
powerful software autrorlz^-tron 
»ystem, turn to PACE Anti '"Tacy- 
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Features 

No source code modifications required 

Automatically locks data files to run-time 
database solutions 

Works with all leading installer tools 

Demo options include days of use, specific 
date, number of launches, unlimited demo, 
and expiring to “nagware” 

Authorization options include serialization, 
machine-unique password, and uncopyable 
key diskettes 

Customizable text messages for user dialogs 

Adds registration information capture to 
your application with no coding 

Available API for use with “non-application" 
components, such as system extensions 
or piug-ins. 

lock in your software 
revenues InterLok! 

Price listed IS for InterLok Sr^ndard/3000 etiiiion 
aiinyni license. See PACE wct> silt for other prices. 

InterLok Standard: Price S499.00 
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// Dtklc Menu 

DeleteH^nu{255): 
MspoEeMeciu(fl_inenu_hatidle): 

I 


Poor Man’s Contextual Menu 
Contextual menus were inirotluced with Mac OS 8. 1’he 
Cftntexlual Menu Manager also can be installed seperately in any 
Mac OS 7.6 and later system; although, this is uncommon and is 
not approved by Apple. While it is alway.s nice to support the 
latest API, what alxiut the majority of your users who will not be 
using Mac OS 8 for a time (if ever)? That is where the code 
G_PoofMan_ContextualMeny provides similar contextual menu 
functions for these older macliines. 

G_PoorMan_ContextualMenu uses the PopupMenuSelectO 
function to aeate ifs own contextual menu. Tfie exicnsiofr nuxlules 
will not work with Fcx)r Man's Omiextuol Menu. Reineml^er, plug¬ 
ins are not supported under Mac OS 8 running on a 68040 niiichine. 
Tile cxxJe calls the same functions as the normal contextual menu 
Ixmdler, so the developer only has lo modify G_ContextualMenu_RII 
Si G_ContextualMenu_Action for it to work under G)ntextual Menu 
Manager API or the G_PoorMan_ContextualMenu cxxle. 

G_PoorMan_ContextualMenu must be called whenever the 
user has clicked the mouse* witliin a window (such as inCx>nTent, 


UiDrag, and inGoAway regions). The routine is passed the 
window the user selected and returns True if' this action invokes 
a PcHir Man’s Contextual Menu, in that case, the program sliould 
not continue to process the event because ii lias been dealt with. 

The routine first cheeks to make sure that the Contextual 
Menu API is not inslallecL and that the current event is a 
mouse-down in a window. 'Ihen it creates a menu handle, to 
l>e used by the PopUpMenuSelect() routine. Just like the 
Contextual Menu API, die Poor Man version has to bringing 
the window to the top and giving feedback lo the seleaed 
item. Tlien the Help item rs added to the menu. Tliis is 
different from the Contextual Menu API, which handies the 
Help menu. Since this menu may appear on the Help window; 
the code accounts for this by disabling the Help item in that 
case. The last bit of setup ha.s G_ContextualMenu_Fill being 
called for the menu items to l^e added. 

Once the menu is fully created, PopUpMenuSefect() is 
called to process the popup menu, [f an item is selected, the 
menu item numlxM is examined. If it is one, then the Help 
menu item w^as selected, and the Help windt>w should appear. 
Any other number would cause G_ContextualMenu Action to be 
called with the correct nurnlier. Finally the tentporary popup- 
menu handle is deleted and disposed. 
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MkLinuX 

Microkernel Linux for the Power Macintosh \ 

MkLinux is a complete system, based un Linux 2 and the 
Mach 3 microkernel. It includes development tools (gcc, 
gdb, perl, X11R6.3, and hundreds of other commands. 

MkLinux builds and runs most Intel-based Linux software. 
It works effidentiy and reliably on a wide range of Power 
Macintosh platforms. Visit Apple Computer's MkLinux web 
site (www.mklinux.apple.com) and Prime Time Freeware's 
web site (www.ptf.com) to find out more about MkLinuxI 

MacPerl: Power and Ease 

MacPerl is a robust and powerful port of Perl 5 to the Mac. 

It runs under the Finder and MPW, supports Apple Events 
and Toolbox calls, and is generally quite nifty! For details 
on MacPerl and associated products (book, CD, etc.), visit 
the MacPerl Pages (www.ptf.com/macpcrl). 

Prime Time Freeware info@ptf.com 

370 Altair Way, #150 (408) 433-9662 

Sunnyvale, CA 940B6 _ (408) 433-0727 fax 


Listing 4: G^PcxirMan ContextualMeiiu 

PtKif Miin Ctmicxiunl Mam (ic. no Mj-nagt^r), Rt-tum true if event handled 

Boolean G_PoorMan_CQntextual_Menu(WindowPtr p_window„ptr) 

r 

Boolean a^flag * false: 

// No Manager, event moujic ikjwn inWmdow & Coniiol Key down 
if (Ig_htive_cotitextuaI_fnenus) f 

If ((g^record.what^^ouseDovn) p wlndov ptr) i 
if ((g^record.modifiers & controlKey)l“0) I 
// livcnt handled here! 

a flag = true: 

Str3155 a_terap_stt = 

MeriuHandle a_menu3andie ^ NevMenu(255« a_teinp„Btr) : 
if Cn_TiioT!u_handlE) ( 

SetPorttp_window_ptr): 

// If Window not from moit. bring it from and draw rm it 

if (FrontWlndowf) l=p_wtndow_ptr) f 
Seler.tWindowfp_wlndow_ptt); 

G_T>raw(p_wind(jw_ptr): 

I 

U If Color Window, hiUte piciun: (invot franit) 

If (p_windov_ptrl“g window about) ( 

SetRectf&g retrt* 0, 0. ZOO, 2003: 
PenHodefsreXor): 

FrartiRHnti {fcg^rect); 

PcnNnrmal(); 


// lii5cn Menu Into Menu Lii^l 

InsertMenu(a_nienu handle, -1): 

// Add About (rMm If Ahtyut Window on top) 

if Cp_window_ptt^g_window_aboiit) 
AppendHenu fa_menu_handle, 

“\p(About ContextualMenuyun...: C"): 

else 

AppendHenu(a.menu handle, 

“ \ pAb out Gont ext ua 1 Men uF : { " 3; 


// Fdl item on menu base on iToni Window 
G_ContextualMenu Fill! 

a raenu_h3 r d1e. p_w indow_p t r): 

// Cali to Handle Popup 

long a_resulL = PopUpHenuSelect(a_menu_handle, 
g^recotd,where.V, g_record,where,h, 1): 

// Unhilitc 

if (p_window_ptr !-g_window about) I 
SetRect(&g_rect, 0, 0, ZOO, ZOO): 
PenModefareXot); 

Fr ame Re ct (r ec 1 3; 

FenNormal0: 

I 

// If call was ok, 

if (a_result) I 

abort a_inenu_ld “ HiWotd (a . result); 
short a^Dienu item * LoWord(a_result3; 
if {a_memi id“Z55) I 
// If help selected, handle it 

If (a_Jnenu_itein™l) [ 

If (g_wlndD¥_about) ( 

£3howWindow{g_window_about): 

S e 1 e c tVi nd ow (g_wind ow .a b o irt); 

} 

3 

else t 

// If normal item selected, handle it (Adjust for Help .Menu Item) 
a_menu^iteiii -- 2; 
C_ContextualMenu_^ction (a_menu_id, 
a_menu_iteiii, p_window.ptr): 

I 

1 

I 

// Delete Menu 

DeleteHenu(255): 

OisposeMenuta_inenu_handle): 

J 

1 

I 

I 

return a_flag; 

I 


Sampu Code 

ConlextualMenuFiin was created to show how' easy it is to provide 
contextual menus to tlic user. Most Macintosh developeis will 
recognize their way around the smndard portions of the program. All 
the axle to handle details of a Contextual Menu is inside of tiie 
G_ContextualMenu njuiinc. Tlie Non-Q)ntexrual Menu Manager version 
of tlie code is inside G_PoorMafi_ContextualMenu. Btxh routines oall 
G_ContextyalMenu_Fil[ & G^ContextualMenu .Action. 

G_Ct)ntextualMenu_Fill is passed the menu handle & seleaed window 
pointer, and fiUs the menu wiiii iiem.s. Assuming the user has chosen a 
command, G_ContextuafMeny Action Ls i)assed tlie clicked window, the 
.selected menu ID & menu item, G_ContextiialMenu_Action parses this 
infonmiion, and lakes action. The axle was written to be exp^lnded, 
which is why menu 113 is parsed. Renietnlx-T, sut> menus ran lx? added 
sf) the menu ID is not always the same. Tlie selected window is passed I 
so commands can be more window and amieni sensitive. 

The new “logical interface'* beg.s Un an object oriented 
approach to handling the contextual menus. A clicked visual 
tibject calls the standard routine to set up the contextual menu, 
using the API or not, which calls a virtual methotl to fill in the 
menu handle with commands. The standard routine would 
then display the menu. Assuming the user selects an item, 
another virtual method would be called to take action. Controls 
and field objects could even put their commands into the menu 
and then call the owning window for the window to put in its 
own commands, and so on up the command chain. 
Commercial or in-house framework,s easily could be modified 
this way to support the Contextual Menu API. K1 
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hy Nat McCully, Senior Software Engineer, Claris Corporation 


Supporting Multi-byte Text 
in Your Application 


How to make most 
efficient use of the Script 
Manager and International 
APIs in your text engine 


Introduction 

You liavc develof)ecl die next greenest 
widget or appliaition and you want to 
distribute it on the Net. Your application 
has a text engine, iriayl>e simple TextEdit, 
Of one of the more sophisticated engines 
available ibr license, or even one you 
wrote yourself. One day, you get an e-rnail 
from someone in Japan: 


_ 

I ili * Wl^ : i thiu tffii rdeJeie ; xt: : 

:^Wy. r Mfi :: 


Suddenly, there are people on the 
other side of the world who want to use 
your application in their language, and yon 
are faced with a dilemma. You have no 
first-hand knowledge of the language 
itself, but you may l>e somewhat Familiar 
with the Macintosli's ability to handle 


multiple languages in a single document with ease. Simply 
cracking open Inside Macintosh: Text seems daunting. How will 
these new routines affect the performance of your program? Will 
you introduce unwanted instability and anger your existing user 
base? Where can you find infomiation on how to use which 
routines best, not just a description of what each routine does? 

This ankle attempts to addre-SvS some of these issues, and in 
general familiarise you with some of die lx3St things that make 
the Mac an excellent international computing environment. 
Intelligent use of the Macintosh's international routines, 
WorldScript, and the other managers in die Toollxix can lx; die 
diJferencc between a US-only application and a truly “world- 
rc^ady" tcKJl that any user, anywhere, can utilize as soon as they 
download it to their hard disk. Although this paper deals 
primarily with Japanese language issues, the concepts outlined 
herein can lie used with any inultiTingual environment. 

What is WorldScript? 

WorldScript is die set of patches to die system tliat enables 
the conect display and measurement of multi-lingual text. Over 
time, many of these patches have been rolled in to the base 
system sf)ftware, but even in MacOS 7/>T, you will find a set of 
WorldScript extensions in the Extensions folder when you install 
one of the Language Kits available from Apple* The concepts and 
code snippets in this paper will work eciually well on, for 
example, die Jafxincse localized Mac OS, or on a standard LJ*S. 
system with the Japanese Language Kit QlK). A good source of 
localized system software and Hinguage Kits is the Apple 
Developer Mailing CD-ROM, available from the Apple Developer 
Catalog, WorldScript is one of the Apple-only technologies that 
makes miilti-lingual computing possible in a far ea^sler way than 
the other guys* When it comes Ltj having Chinese, Korean and 
Ja[rane,se all in die same document, WorldScript, on Mac OS, is 
the only thing out there, 


Nat McCiiUy him Ix^cn at Cbris in the Japanese Developiiieni Gmup for the last 6 years, lie has worked on numerous Japanese 
products, including MaeWhte 11-J, Hlcmaker Pro-J, Claris Impact-J, ClarisDniw-J, and ClarisWorks-J. He speaks, reads and writes 
japaTi(?.se, and enjoys traveling in Japan. He Ls cuixently working as Development Lead on the next release of ClarisWorks-J. 
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jPasif, Reliabtef; < 


6*0^ RasterNet- 2.0, RasterNote- 2s(l‘ I 
? , K^sterMaster 6.0 Imaging support for 
^ S0+^ Raster Formats 

rM, JPEG, araup3" Group4, MO:DCA lOCA, CALS, PNG! 
GIF, PhotoCD, ABIC, Targa, Flashpix and mote. 

?|: j'lidudes: Fon^ Saving, Coinprcssiou, Despcckle, . 

Zoom, Deskew, Anti Aliased Display. Image 
Processing, Tr^n'^p^rent Color,. Scaniiitt^^^ G.oldr'H^duGii^M^^^^^^^ 
Promotion,'Medical imaging Option awrf 
RasterNote 2,0 Annotation/Redlining toolkit meiiiddf||| 
popular features: Sticky Notes^ Lines, EHipscSt Ffeehaii|;L 
^ ■•.Drawing, Highlight, Polygons, Redaction 
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Multi-byte Text t)N the Mac 

OK. let’s get lu the meal, you siiy„ How do you make your 
text engine handle twobyte chanicters? Well, Ix'fore giving you a 
bunch of code, let s explain how' the Mac handles two-byre lext. 

Wliat is a Script? 

Each language that the Mac supports is grouped into 
categories called ^scripts.” For example, English and ihe other 
Roman ietter-f>ased languages like Frcneh and German all Ixdong 
to the Roman scrif:it. Japanese Ixdongs to the Japanese script. 
Character glyphs in ilie Roman script are eac h rep restated liy a 
singlc-l:)yte diaracter code. Japanese characlLTs are represenLcd 
by a 16-bit (2 byte) character code. 

Setting Up the Part: Pre-System 7 APTs versus New APFs 

On the Mac, each font is also associated with a script. There 
are Roman script fonts like Helvetica and Palatino, and Japanese 
script fonts like Osaka and Heisei Minchoiu As you know, when 
text is drawn itiro a QuickDraw grafPort, you first set up the port 
with the appropriate font, size and style, and then call DrawText() 
to dr^iw- the text. Lf you are using the old Script Manager APVs 
(like CharByteO and GetEnvironsQ), you need lo set the port to a 
font in the script you are interested in processing. Once the port 
is set to a particular font, calls to the Script Manager svih follow^ 
the rules of thai fonfs script. So the port, by way of setting the 
font, also has an implicit scrip! setting. Tins is die key io using 


the Script Manager routines so they will return the correct 
information to your application using the older API’s. The new 
APTS have a script parameter, so it is not necessary to set the font 
of the port before using them. Since the Script Manager tloesn’i 
have to c:all FontScript() to find out the script of the current font 
l:?efore passing die script to WorldScript, using the newer APFs 
could speed up your application is certain cases. 

Adding Script-sawy Features to your Application 

First, you need to determine if the user’s system has a nan- 
Ronian script system installed. Many programs boost 
pcrfortnance by calling Script Manager routines only when 
absolutely necessary. One way to find out ail the scripts installed 
is to loop through all 33 possible script codes (smRoman being 0 
and smUninlerp being 32) and calling GetScriptManagerVariableO 
widi die selector smEnabled. Roman script is always enabled. 

Listing 1: Finding Which Scripts arc Installed 

ScriptCode script: 

for (script - smRonian + 1: script ssiUninterp: script-H-) 

4 

4f {Gt!tSc'.rlptManager¥atla'hlp.[ficript, smEnabled)) 

IniLlnicrnalScripLlnfotscript): 

// noii-Ronrtin scripi present--- 

) 


InitInternalScriptInfoO refers to a routine you write that will 
initialize your internal data structures ihai deal with specific script 
systems, such as line-breaking tal>les, on a scTipt-l>y-script Ixisis. 

IJNE RRFAKING 

Most applicalion.s dtui’l rely entirely on die Script Manager 
for line breaking, hit testing, or word selection, l>ecause using 
those routines is thought to be too slowc It is possible to 
optimize your text engine so that you incorporate the correcM 
behaviors for each script system present, while iiiamtaining the 
highest possible performance. The Toolbox call for finding line 
breaks is Sty[edLineBreak(). To use it, however, you must restrict 
the text you [lass il Lo [engllis of less than 32K (aclually, this is 
true of the whole Script Manager, so tougii) and text wudths to 
wdiole pixel values (can you say rounding error?’), and if you 
are explicitly scaling the text, il won’t work ii\ alL You must also 
organize the text you pass to it in terms of script runs and sty le 
runs within them. Therefore, must applications that have word¬ 
processing functionality choose to implement iheir own line- 
breaking code that is customized for tlieir own needs. 
Unfortunately, many of these private iniplementations break 
when used on WorldScript systems. 

line Breaking with Japanese Text 

I'he simplest line-breaking algorithm for English text is to 
look for a space (ASCII 0x20) character in the line near the 
graphic break, and if there is none, to break on the byte- 
boundary nearest the graphic break, Japanese text is a bit 
more complicated, Japanese text has no spaces, so you must 
break at the characier boundary nearc.sL the graphic break. 
There is an additional wrinkle: Certain characters are not 
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allowed lo begin a line, and certain cimratiers are not allowed 
to end a line. This set of line-breaking rules is referred to as 
Kinsoku sbori. For example^ you cannot begin a line with a 
two-byte period. You cannot end a line with a tW'od>yte open 
parenthesis follow^ed by more text on the next line. A list of 
kimoku characters is available from the Japanese Standards 
Association in the form of a Japanese Industrial Standard (JIS) 
document. It is also in Ken Lunde's excelleni book, 
Unc/ersiamitn^ Japanese fnfor7naiion Processing, in the 
section entitled ‘'Japanese Hyphenation." While not all 
Japanese agree on the correct set of kinsoku characters, this 
set is a gotjd default. Some applications allow the user to edit 
the kimoku character set to their own liking. 

Once you know that the current byte offset in your text is 
<m or jusi before the graphic break, you need to see if that byte 
is part of a Lwo-byie character. Then you need to see if the 
character is a character that can't end a line, Tlien you need to 
check the character after it to see if it is a character that can't 
begin a line. This can be repeated as necessary, for support of 
a string of kinsokt4 characters. For example, suppose the 
chameter on the graphic break (the break char) can end a line, 
but the character after it can't begin a line, causing the break 
char to wrap. However, the character l>cfore the break char is 
one that can't end a line, so you must then clieek the char 
before it, and so on, and so tm, and.,. The example below is 
siinpUried to illustrate a particular case; actual code for an 
application would probably be organized differently. 

ilsling 2: Checking Grapiiic Break Char with Kinsoku 
Processing 


(ai<^OraphicBn.-ak 

Check i text fnn*s length against tlic pixel edge nf the line (the so-ralletl graphic 
bleak), and rhen adjust ihc l«ic break if there Is an illegal cliaraeltr on iht 

break. 

Ulutl6 * gStartLineKinRokiiChat s: //chars dial can 1 begin 

// a line. 

UlntB gNumSta rtKltisokijChars: // tiomber of char?! above. 

UlntlG “ gKndhlncKinsokuChacs i //chars that can’t eotl a line 
UIntS gSumHndKinsokuCha rs : // iiuinher of chars above. 

//This funakin will return FALSE if rhe char at ofifset 
// is not a valid break point It checks the char after ii, 

// bill not die diar beftjre it for kinsoku 

static Boolean ChcckGraphicEireaktUIntS * textPt t . 

Hint 16 offaet, 

ScriptCode script): 

1 

Sint 16 result; 

//'ITie lexilhr starts at a known gptHt diaracier 
// boundarv'. Fn this case it is the beginning of the 
// tine, hut it could be the lx:gmnuig of the 
// stylmm. 

// Find out if script only has i-l>yte chars. If so, 

// we assume h s iik to break at this eliar. 
if (GetStriptVariable(script, smScriptFlags) h 
(1 << smafSingByt^)) 
rsturn TRUE; 
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tmu It = Cha t ac t G r By t eTy p e ((Ft r) text P t r» 
offset, 
script): 

If (result “ smSiagleByte) 

return TRUE: //in rcaJ life,you'renoi done 

// untU you check the chars before 
// and aAer tids one for kinsoku. 
if (result ^ sraFirstByte) 
return FALSE; 
if (result “ sinLastByte} 

I 

UIntS index: 

UIntl6 theChar - '(UlntlB •)&textPtr[offset - Ij : 

// Now we have a valid break on a 2'byte char. 

// Wc need to cheek if itV a kinsoku character, 

//'Itiis code checks Japanese kinstiku only bui 
// with a Hide wort tliis could be extended to 
// all 2-bytc scripts that don't break on spaces, 
if (script smJapanese) 
return TRUE; 

for (index - 0: index < gNumEndKlnaokuChirs; index-H-) 
( 

if CtheChar gNumEndKlnsokuChars [index]) 
return FALSE; 

I 

// Now wc check the char after this one. in case it 
// Is a char that cani start a line. Hrst set if 
// ft's a l-bytc char In real life, there an: I-byte 
// klnsoku cliars to check for. 
if CtextPtr[offset + 1] “ NULL |j 

Char3CterByteType{(Ptr)&textPtr[offset + L)* 

0, ncript) “ saSlngleflyte} 
return TRUE: 

theChar " * (UlntlS *)fitextPtr[offset + 1]: 

for (index " 0: index C gNumStaetKinsokuChars: 

index++) 

i 

if (theChar ™ gNuHiStartKinsokuChars[index]) 
return FALSE: 

) 

) 

return TRUE: 


single pass over the text is much faster than calling 
CharacterByteTypeO for each byte. An example of this is below, 
in a sample function that goes through a text stream and counts 
the number of characters in it: 

listing 3; Counting the Chars in Mixed-byte Text 

CouatGmrsInScripiRim 

Counts the number of characters in a run of contit^uous script (font), checking for both 
one^vyte and two-byte duracters. 

0Int3Z CountCharflInScriptRun(Ulnt8 * textPtr, UInt32 length. 
ScrlptCode BcriptJ 

UIntS paraeTable[256]: 

UInt32 curByte* charCount; 

(vold)FillPflrseTable(&parseTable* script): 

for (curByte “ QL, charCount “ OL; curByte < length: 

curByte++) 

I 

if (parseTableltextPtr[curByte]] “ 1) 
continue: 
charCotjnt++; 

) 

return (charCount): 

J 

Notice that because we started al a known ‘good* boundary, 
we were able lo test only the first bytes of die two-byre 
characters in the stream as we counted along. This code would 
not work in all cases if we srarlcd at an arbitmry point in 
unknown text, 1-Hfcause of the ambiguity of the byteness of some 
character codes in some scripts. Caching the parse tables for all 
installed scripts in die user's system at laimcfi time would further 
speed up your processing, so you wouldn't have to call 
RIIParseTableO every time. 


Hit Testing 

Hit testing is another area in your text engine that demantls 
die liighest possible perforniance. When the user clicks in the 
text, any delay in setting die insertion point them will lx; noticed. 
Drag .selection is anodier example of the same code working haul 
to find die character boundaries and setting the connect hilite area. 

Some applications u.se a locally allocated cache of possilile 
first byte tliaracter ctxJes that they use to Lest a particular 
character in the text stream for bytencss. This Ls simple lo create 
with the Toolbox call FillParseTabIe(). FillParseTable() returns in 
your pre-alloeaied 256 byte buffer all the liytes that can be a 
first byte of a iwo-byte character in the scTipi you pass to it. Be 
aware that in some scripts, some character ctxles can be Ixah 
the first byte of a two-byte character as well as die second byte 
of a two-byte character, depending on their context wjdiin the 
text sirc^am. Therefore, you need more than just this information 
to successfully find out what kind of character the byte ytmVe 
interested in is a part of. In a mixed stream of text wilii lx>th 
one-byte and two-byie characters, using the parse table in a 


Mli^\SiriUNG TWO-BVIT- CHARACTERS 

On the Mac, all two-byte characters are the same width. In a 
future system software nelc*ase, pro[x>nional two-byte thamclers 
will be supported, but up until now all two-byte-sawy 
applications as.sume mono-spaced two-byte characters, and even 
if pnotKiriional characters are supfiortcxl, they will Ix^ mono-spaced 
by default so as not to break every application currendy sliipping. 

Before the Mac OS supported mea.suring two-byte 
characters with TextWidth(), a .special code iKiint in the single- 
byte 256 char width table was reserved for the two-byte 
character width for that font, in the Japanese and lx>th 
Chinese* scripts, this code point is 0x83, In Korean script, it i.s 
0x85. T\m code point still wt>rks, even though Apple now 
rccomtnends you use TextWidth() for all measuring tsf multi- 
byte or mixed text. In the future for proportional measuring, 
TextWidthO will probably lie what you will use. 

Bck>w is an example of a funaion that measures any text, 
and returns the amount in a Fixed variable. This i.s useful if you 
are measuring text and the user has Fractional Glyph Widths 
turned on (meaning you made a call to SetFractEnabtef)). 
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Listing 4: Measuring Mixed-byte Text 


fSetlMiWidth 

This functitm supports multiple stylcmos in the text, and consists of two loops: One for 
the styles and one for the dimeters in eadi styte.The port is set on each stylcrun and 
then Macintosh APIs an: called to measunt the text, 

^define dSCTCWidthChar0x83 
#define KWidthChar OxBS 


typedef struct ta^StyleRuu f 
0Int32 styleStart; 

Ulntlfc font; 

QTntl6 size: 
tJinte face; 

] StyieKuti, "StyleRunPtr: 


Fixed GetTextWldth{UInt8 * textPtr, UInt32 length* 

StyleRunFtr atyloRuns, tjlnt32 numStyles) 


ScrlptCode 

aTnt32 

Fixed 

ScriptCode 

FMetricRec 

WidthTeble 

UIntS 


curScript: 
byteNum, styleNun: 
totalWidth “ OL; 
curScript; 
curFontHetrlcs; 
**curl(fldthTable; 

pacseTablet256j; 


// loop thni each stylcrun. mrasure its characters 

for (styleNum “ OL; styleKuja < numStyles; styleNuni++) 

// Set up the port (in real life, youd restore the 
// old settings when you exit) 

TnxtFont fstyleRuns[styieNum],font); 
TextFnce(styleRUTisLiTyleNiml ,face); 

TextSiaeCstyleRuns [styleKuifl] ,slzej: 
Fontfletrics(^curlontHetrlcsj; 
curWldthTflble - cucFontHetrics.wTabHandie; 

HLock((Handle)curWidthTabieJ; 
cncScrlpt * FontScript0 : 

(void)FlllParseTableUparseTable, curScript); 

// k«p thru each char in the stylcrun 
for (byteKum - styleRuns[stylENmn].sryieStart; 
{styleNutn + I < ntimStylea H 
byteNufi C styleRuns[styleNum+l].styleStart) l| 
(siyloNioa + 1 >= nuinStyles it byteNum < length); 
byteNuirH') 

I 

if (parseTableftextPtr[byteKum]] = 1) 

if (curScripi ^ umJapanese || 
curScript “ smTradChinefie [| 
curScript = smSimpChlnefie) 
totWidth i- 

(•curWidthTable->tabData)[JSCTCWidthChar]; 
else If [curScrlpt amKoreanl 
totWidth +* 

CciirWidthTable >tabD3ta) [KUidthChar]; 

h 1 HP 

LutWidth (Fixed) 

TextWidth(&textPtr[byioNufii] , 0, 2) « 16; 
byteKuin+i; 

1 

elne 

toiWidtb += 

(•cUrWidthTable'>tabDats) [textPtr[byteNuniJ J: 
HUnlock( (Handle) curWldthTable); 

1 


return (totWidth); 

1 


l“he above function still makes expensive calls like 
FonlMetricsO, FillPars 0 Table() and TextWidth() on each stylenin. ii 
would Ik: an even better idea to have a kx:al cliche of the width 
tables and parse tables of fonts you know are in the dtxTiment* 


so you don't have to rebuild them every time the user clicks or 
drags or types in the text 

So, now that you have a relatively fast way of measuring 
die texi^ you can use it to find die pixel value of any character 
in the text* and use that for your internal CharToPixel and 
PixelToChar logic. Or, you can use the Mac OS Toolbox citlLs 
CharToPixelO and PixelToChar()* which will always work on 
any script but may be slower. 

Localizing Your Appuc:ation for Japan 

Now that we have reviewed a few of the liasic text engine 
issues for handling two-byte text, there are a few things about 
Japan in particular that make localization a challenge. 

Japan is possibly the most interesting major software 
market to localize fur, if you are interested in text and text 
layout. It is a mature market, with a diverse number of producLs 
enjoying many millions of dollars in sales each yean The 
Macintosh has a larger market share there than in the U,S. or 
Europe. Text in Japan has traditionally been difficult to input 
and output using machines* and the use of text in graphic 
design requires that the text layout lx? extremely flexible. I'he 
characters are complex (so complex that (miding them may 
make them illegible), and emphasis or adornment has form.s 
that use background shading, different type.s of lines around the 
text, and even dots or ticks above or lo one side of each 
character. Condensed and extended faces have different results 
on PostScript printers than they do on QuickDraw. Bold and 
italic faces were not supported on the first PostScript Japanese 
primers. Underlines are not drawn by QuickDraw when the 
font is a Japanese font. These last two things might l>e fixed in 
future releases of the system stiftware, but for now die 
application developer must work around them. 

For underline, you must draw a line under the text. 1‘he 
reason QuickDraw doesn't draw it for you is that it u.sually 
uses the font's baseline as the underline location, but 
Japanese fonts' two-byte glyphs take up more room and 
descend Ixrlow the baseline. Where you draw y()yr underline 
is up to you, but lake a lo<>k at how other Japanese programs 
do it and make it fairly consistent. 

Vertical text is pretty much a checkbox item nowadays in 
Japanese ward-pnH:essing programs. Most novels and many 
magazines are layed out vertioally, but until recently cQinputcr.s 
were horizontal-only. Wliile die Window.s9^® APIs support 
drawing text vertically, the Mac OS still does not, ouiside of using 
QuickDrawOX ty^xigraphy (which is excellent, by the way). In 
comparing vertic'iil text to hori/arntal text, several things cliange 
about the line layout: Ihe first line starts at the top right, and the 
text flows down to line-end, then wraps to die next line, which 
is to the left of the first line; die baseline is generally coasidered 
lo \}c in the center of the line; underlines are drawn to the right 
of die text, as are emphasis dots; two-liytc characters are not 
rotated, but single-byte characters are* 90® clockwise; certain 
c:haractens have vertical text variants, like many punctuation 
characters. Where these variants are in the font can be found in 
the late' table in the font Otahteh'" meaas ‘‘venical" in Japanese). 
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Ru[)i are small :mnotatif>n charuclcis, plac<?Li aix>ve, 
hclow or to the side of the text they anootate. Usually tliey 
provide proniineiation guidance for unusual or hard-to- 
pronounce Kanji characters. 

Date formats in Japan include the current year of tlie 
emperor's reign; again, supponed on Windows95® hut not 
on Mac OS. It is up to the application to support these 
Formats if so desired. Also, date formats 2 and 3 produce 
identical results, due to tlie fact that the abbreviated month 
and the long m(mLli are the same thing in Japanese. Japanese 
applications may opt to substitute a different format in one of 
those formats' place. 

Find and Replace needs to be expanded to include the 
different lypc‘s of characters used in Japanese. Standard 
Japanese text may contain any of the following types of 
characters: one-byte Homan, two-byte Homan, one-byte 
numerals and symbols, two-byte numerals and symbols, one- 
byte katakana syllables, two-byte katakana syllables, two-byte 
hiragana syllables, ami two-byie Kanji characters. The 
hiragana and katakana characters are equivalent in lerms of 
the sounds tliey represent in Japanese, so a good 
Fiml/Replace function should include an option to find the 
search string in either syliabary. 

Sorting in Japanese is difficult liecause the Kanji 
characters can have different prominciaticms depending on 
their context. To son Kanji correctly, you need a separate kana 
key field that indicates the pronunciation and you sort on that. 
Also, Mac OS CompareTextO doesn't son the long sound 
symlioi correctly (that symfiol changes sound depending on 
the character before it, hut Mac OS always sorts it in the 
symbols area), -so for linguLsiically correct sorting you need to 
write your own sorting routine* 

tf your applicatitm supports character tracking using the 
Color QuickDraw function CharExtraO, be aw^are that the 
CGrafPort member ch Extra only uses 4 hits for signed integer 
values and the other 12 hits for the fraciion. The value you 
pass to CharExtraf) is a Fixed value of how many pixels you 
want U> track out (or in) the text, and QuickDraw divides that 
by the current lext size* to arrive at the chExtra value. This 
means that if the tracking value you pass to CharExtra() is 
greater than 8 times the fexi size, the chExtra field will go 
negative, and yotir text will be drawn incorrectly. 
Unfortunately, Japanese lext is routinely uacked out beyond 
this limit in many applications. The only workaround is for you 
to draw the text one character at a time, anti use the 
QuickDraw pen movement calls like MoveloO lo move the pen 
yourself, 'fhe same is true for SpaceExtra(). 

Inuine Input 

Inline inpui of Japanese, Chinese or Korean is a way of 
LLsing an intermediate program (called an Input Method) to 
translate your keystrokes into the many thousands of possible 
characters in those languages, aU in the same place on screen 
that you would nonually see characters typed in the line, in 
Japanese, the Input Method clianges your keystrokes into 
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phonetic Japanese kana characters, then convcns some oftho.se 
characters into Kanji charaaers to form a mixed karui and Kanji 
sentence. Then the user hits the return key to confirm the text 
in the line, ending the inline input session. Inline input on the 
Mac on System 7.1 or later uses tiie Text Ser\aces Martager 
(TSM). If your a[>plicatton uses TextEdit as its main text engine, 
you can support inline inftui cjuite easily using 'I'SMIT. If you 
have your own text engine, you will need u> do more work to 
support TSM Inline Input. 

TSM uses Apple events to send and receive data between 
your application and the Input MeUiod. You must implement 
several AppleKveni handlers, the most cQm[)lex of wliich is die 
kUpdateActivelnputAraa. In that handler, you must draw the text 
in all its intermediate stages, a.H the user is comjiosing and 
etliting the Japane.se sentence Ixdorc s/he confirms it to the 
document. If there is text after the so-called ‘inline hole/ you 
must actively reflow tlie text if such editing causes the length to 
change. Each time the user makes a change, the text in the 
inline hole is received from the Input Metliod in an Apple 
eveiir The appliolion draws it in the text stream, along %vitli 
special Inline styles that help die user lefl which text in the 
inline hole is raw (unconverted) text, which is t:onveried text, 
wliich is the active phrase, where the phrase boundaries are in 
the inline hole, and other information. 

After implementing the TSM support in your appltcaiion, 
it is imperative that you lest it with third-party Input Mediods. 
At the lime TSM was introduced, the documentation for liow 
to write an hipin Method was .still a little spotty. This resulted 
in each input Method handling text slightly differently. Also, 
Koloeri, Applets Input Method, has fewer features than the 
leading third-party input Methods. Be sure to lest your 
application with all of them you can find, so you can verify 
that it won't crash or produce strange resulLs. S<nne Input 
Methods have strange quirks, like always eating mouseDown 
events, or having different recfuirements about how large a 
buffer they can handle wiilumt crashing. This knowledge 
ctjmes from testing, and sometimes can be found on die 
Internet in Usenet newsgroups (in Japanese). 

What ABOiri Unicode? 

Unicode is being billed as the latest panacea for ilie 
problems of internationati?:afi<in. What does Unicode give you? 
Where does it fall short? 

Unicode was designed to solve one [problem: Tfiere are 
many incompatible, overlapping encoding sSchemes for different 
languages, and supfioriing all of these encodings is a complex 
problem. What if there was a single encoding scheme that 
supported all the writing systems of the world, and guaranteed 
that you could display text in all the languages Unicode supjx>!ts 
if only you had the right Unicode font for each language? 
Unicode tries to be that enctxling. 

For Japanese text data, the Mac OS and Windows9S use 
Shift-JlS internally, while Rhapsody and WindowsNT’® use 
Unicode. On the Internet, most Japanese text is encoded using 
tlie 7-l)it ISO-202ZJF standard. Whether or not you use 
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Uniccxie to represent text internally to your applic‘ati<m, you 
will have to support all three standards for full file and data 
compailbility with the rest of the world, in Unictxle, all 
characters are two bytes hmg. you no longer have to 
worry about testing for byteness in a UnictKle stream. 
IU>wever, all ASCII cbaraclers are represented with a leading 
0x00 in Unicode. So yuu can't have loops that look for a 
terminating NULL in a C-string. And, all your formerly one- 
byte text doubles in size unless you explicitly compress it (and 
then you lose the byteness testing advantage). 

Whether or not you tliink testing byteness is too 
complex or expensive to do, you should know that Unicode 
also doe.s another controversial thing: For the so-called 
**Han" languages (Japanese, Cliinese, Korean) that use 
characters that originated in China, it attempts unify them 
inif) one codepoini for each character judged by the Unicode 
ConsOFliuin to be unitgie, even if it has variant forms in each 
language. The same is iriic for Araliit' languages (Persian ik 
Farsi). Because of this, you cannot tell wlial language a 
character is in just from its codepoint, Unicode was not 
designed to be a muUi-lingual solution, in that 
representations of Chinese and Japanc.se in the same 
document will have overlapping character codes, re<juinng 
the OS to provide a parallel linguistically-coded data 
structure to render the glyph forni.s appropriately to each 
language. This might be another version of today's 
foni/scripi/language relationship on Mac OS. As you can 
imagine, the Chinese, Japanese and Korean governments 
have each published competing encoding standards if) 
Unicode, labeling the latter as something designed by 
foreigners who didn't understand the issues (both political 
and linguistic) involved in trying to make a worldwide 
encoding system. 

Another is.sue about Unicode is that although it can 
re(>rescnl 65,536 charac'ters, there is not enough space for all 
the I Ian characters and dteir variants, plus all the other 
languages that Unicode currently supports. New languages are 
becoming computeriztxl a.s more countries join the Digital 
Revolotion and the Unicode Consortium cannot give space to 
all of them. Preferring the fiat encoding iiKidel, they came up 
will) another standard that uses four bytes per character (die 
ISO 10646 encoding standard). Given that on the hiteniet, 
where many languages need simukanefyos support on 
computers, bandwidth is at a premium, I would prefer using 
the ISO 2022 standard of mixed-byte (7-bit and 14-bii 
characters) plus the e.scape codes that tell you what language 
the current stream is in to sending 32T>it characters through the 
wire. Since most web pages use this encoding, expect your OS 
to provide utilities for enctKling conversion (like the Mac OS 
Encoding Converter debuting soon on a near you). 

Cross-Piatform Development Issues 

Going cross-platform is already complicated without 
having to think about intcrnationalizaiion. Should you have 
separate codebases for maximum use of eacli platform's 
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unicjuc features? Or should you have a single codehase and 
use an emulation layer for the other OS's APIs? Each has its 
advantages, but for this article I can speak to those of you 
who have a joint codebase, and tell you about some of ilic 
tilings that the Windows platform lacks thai you have to write 
yourself for multi-byte support and internationalization. 

Windows has no .Script Manager, Tliere is no Gestalt 
Manager. It cannot support multiple tw'o-hyte codepages at the 
same time. Tt uses totally separate fonts for veriic:al and horizontal 
text. It .supports propfmiooal kana in Jafjanese, so you can't 
assume all two-byte characters are the sante width, 

If your ciide uses the Script Manager iT>utines heavily, tiien 
you will have to write them yourself on the Windows side. All 
tlie convenience of the Mac OS’s international routines comes 
very clear wfien you try the same things on a PC! 

Also, Japan once again has its own special challenges. 
Until Windows came out in japan, each computer 
manufacturer made its own proprietary 05 and hardware. 
Even floppy disks were incompatible with each other Now^ 
most companies have adopted the Intel ?C standard, but NEC 
continues to manufacture its own line of incompatible PCs. 
NEC has such a huge share of the market in Japan that it has 
teamed up with Microsoft to produce its t>wn version of 


Windows95 for NEC. So when you buy Windows95 in Japan, 
you find there are three versions: MS Windows95 for Intel, MS 
Windows95 for NEC, and NEC Windows95 for NEC. All three 
versions are basically the same feamre-for-feature, but the 
drivers arc different and you need to test your application on 
each platform to verify compatibility. 

On the hardware side, you will find that Japanese 
hardware Ls different: They use different displays, different 
keyboards, different printers, and different floppy formats. 
The drive lettering on NEC machines is different from Intel 
PCs: The hard disk drive is labeled 'A:' on one and 'C:* on 
Uic other. Make sure your installer isn't hard-coded to install 
on drive C:, 

CONOXtSION 

As we have seen, internationalization of your software on 
Mac OS IS not very difficult to do, and it is to your benefit to 
try and enable as many users as possible to enter text in their 
own language when using your program. We have also 
examined Japanese localization in more depth, and 
demonstrated that Japanese language applications usually 
retjuire some amount of new features tfe.signed specifically for 
that language's neetis and conventions. As more markets 
around the world reach maturity, you can he sure that there 
will be ample opportunity to differentiate your pnxluct by 
adding locale-specttk' features. Ii is iliesc locale-specific 
features that will tell your users that they are valued customers, 
ami that their needs arc l>cing addressed in a very specific way. 
For your product, especially if you are in ihe initial designing 
pha,se.s, I would recommend you try to make it as easily 
expandable as possible. Design generic InLernalionization into 
the core modules, wliilc leaving ojxfii the opportunity to add 
locale-.specific features fur certain markets like Japan, as you 
sec your product's market expand and rise in success. 
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The Mac OS, STL, & Iterators 


Take advantage of the C++ 
Standard Library Algorithms 
with the Mac Toolbox 


Iterating The Toolbox 

There are many parts of the Mac OS 
Toollxjx tliat require you to seaieli for 
what you need. Search for files with a 
certain type code. Search for a process 
witli a particular creator code. Search for 
niounied volumes that arc removable* The 
list of managers in the Mac OS that recjiiire 
seartihing goes on an cl So, we write 

search and loop routines to do the work. 

Now wait a minute. Aren’t there 
generic routines in the C++ Standard 
Template Library (STL) that can search and 
locate itcnis with specific criteria? Those 
won’t work; they only work on iterators 
and containers in S'll, right? 

In Fact, the STl. is very flexible and 
cxlcnsilde* In tills aniclc, you will Icam liow 
to Like acfvantage of S^FL algorithms to seaidi 
Mac OS Toollx)x maiTigers* Spedhcally, you 
will learn how to write a forward iterator thai 
satisfies die criteria for Sll algoritlniLS in 
order to take advantage of them 

STL I>j rR(:DUc:nt>N 

First, a word from our friendly C++ 
standards committee. There really Isn’t a 
Standard Template Library any more. All of 
the features and functions of the STL were 


rolled into the C++ Standard Library proper. However, liistory 
once called it the STl., and that name lives on. What we refer to 
in this article as the Standard Template Library Is the generic 
algorithms, containers, and iterators that make up a large portion 
of the C++ Standard Library. 

Tliere are many articles and excellent Ixxjks written about 
die Standard Template Library. We won’t go into a great deal of 
detail here, but we will give enough background about generic 
algorithms, iterators, and funclion objects so that everyone 
should understand what follows. If youTe experienced with 
using the STL for its valuable containers, like vectors, lists, and 
maps, you might want to skip to the next section* 

STI. is made up of 5 daHS,sifi era lions ()f objects: 

• Generic Algorithms 

• Cxintainers 

• Iterators 

• Function Objects 

• Adapters 

Generic algorithms oijcratc on ctmlainers l>y using iterators* 
'Ihe generic algorithms can be specialized and extended by using 
function objects. Adapters can be used with iterators and 
conUtiners to modify their behavior. We are interested in the 
algoritlims and iterators. Because we need to specialize tlic 
algorithms, we will also use function objects. 

Containers 

Containers store objects. Containers own tlie objects that are 
stored in them. Containers also provide the iterators designed to 
iterate through the objects in the container. Container classes in 
tlie STL include vector, list, deque, set, and map. Each container 
ha.s its particular feature set. These containers are invaluable for 
data storage in your application, but we won’t be talking about 
tliciii in tiiis article. 


Diiane Murjjhy <dmurphy@beamVGr.com> Is a Senior Coasullant lor Bear River Associates, Inc. He has been programming for 
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Ills computer, he can lx: found playing witli hi.s two daughters, unle.ss they’re .sirting in front of tile computer. 
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Adapters 

Adijpters are used with iterators and containers. An iterator 
adapter ran make a forwarci iterator into a reverse iterator, for 
example. A container adapter can turn a deque into a stack. 
Ada[>ters are uLso very useful for your application data storage 
requirements, but again, we wort'i be needing them here. 

Aigoritlinis 

iTiese are the functions that we want to take advantage of. 
MTie most often used algorithms are for^each, find, and findjf. 
Sometimes you might use count or count_if. for_each will execute 
some function (using a function object) for each element 
specified by a pair of itemtors. 

Itenitars 

Iterators are the objects that connect algorithms to 
containers. Algoritiuns are always written in teniLS of iterators. An 
iterator is an abstraction of a C-^+ pointer. In fact, any algtJrithm 
cim work with a C++ pointer as the iterator. 

Function ObjccLs 

Finally, a function olTjcct, also known as a funclor, gives the S^ll 
an ol>ject tliat can modify the l:>ehavior of an algorithm. For example, 
the for_each algorithm will apply a funrtion object to an ilcralor. Tlie 
find_lf and counLit aig<yrithins use a function Ql>ject as a test, known 
as a paxiiaite, for seiutiiing and counting using an iterator. 

Mac os Containfjis 

As ex()laincxl alxwe, itemtors are the tjl:>jms that allow 
algoritluiis to ojxrate on the contents of a conutiner. Algorithms 
don’t have any dired knowledge of a container. Thv container is 
completely isolated ittskle the iLerator In the S'!!, iterators are 
usually provided by the container. Of course, the Mac OS dtxsn't 
know anytliing alxxit the S'll; so we have to build the iterators rhat 
would be providixl by the iVhic OS, ;is if it kaew^ alK>ui tlie ,S71. 

To build ilie iienuors we must tliiiik in renns of the S'H. In 
t)arlicular, iterators |)rovide access to the elements ol a container. 
We have to ft ml the containers in the Mac OS and then figtire out 
how to represtmi an iterator over that container. You ran think of 
a c:oniatner in tlte OS as anytliing dxu has a list or group of things 
tliat are tlie simie tyjx. In this article, we will use as examples: 
processes in the Process Manager, vofumes in the file system, and 
files in a dircriory. We ran Uiink of the Process Manager as a 
container thal has a list of processes running in the system. We can 
think of the file system as a container that has a list of volumes. 
We am think of a tlireitory on a volume as a t:ontaiiicr of files. 

Tliere are many other exatiijiles of lists of objects in the Mac 
OS, Eiitch of the.se can lx thought of as a container If you can 
access the objem in some order, then you can l>uikl an iterator 
to use with the algorithms in the STL. Tliinking in the s;imc tenns 
as live STL will helj> yt)u to ixtter understand iterators. 

SIX Iterators 

Becattsc iteratirrs are Uie interface between containers and 
SIT algorithms, the focus of this article is on S'll iterators. In 


particular, we would like to uike advantage of the algorithms in 
tlie STL to iterate over lists or groups of objects in the Mac OS. 
To do this, we must know the requiremencs of the iterators of tlie 
Standard Template Library. 

IteratoHi in the STL come in five categories: 

• Input Iterator 

• Output Iterator 

• Forward Iterator 

• Bi-directional Iterator 

• Random Acces.s Iterator 

Input and output iterators are used to iterate over streams. 
Forward iterators can only increment. Bi-directional iterators can 
incTement and decremcnl, while random access iterators use the 
index ojxrator to dereference any location. While there is no real 
inheritance in the iterator categories, you c:an .see tlrat each 
iterator category has increasing functjonaliiy. 

Forward Iterators 

'ITie parts of the Mac OS Tcxtlbox ihai we are interested in 
are usually candidates for forward iterators. The vSTL algorithms 
have a few reciuiremenLs for the forward itemtor. 

1. Default Constructor, A tlefault constructor can usually be 
ii.sed to mark Lhe end j>oint of tlie iteration. We will see 
exainj^lcs of this in our iterators. Additional construaors can 
also lx defined. 

2. Copy Conslructor. Iterators are meant to !x lightweight. 
They are, after all, an abstraction of a pointer, Itemtors are 
aimo,si always passed by value; therefore, a copy 
constRjctor is needed. 

3. Comparison Operator, Sll. algoril[un.s o|KTalc over a range 
of a container. A Ixgin and end iterator are provided to the 
algorithm. The comparison operator of the iterator is used U> 
determine when the range has Ixen t:ompleted. 

4. Assignment Operator, For the same reason we need a 
copy constructor, we need an assignment operator. 
Iterators are lightweight, passed by value, and are easily 
assigned to one another. 

5. Dereference Operator. This is how the algorithm gets 
access to the container. The algorithm will use the 
dereference operator of the iterator to get tlie value of tlie 
container identified by the ilenttor. 

6. Prc-incrcmeiU Operator Tliis is the fundamental iteration 
function. 'JTe algorithm will iterate over the <-oatatner by 
calling the pre-increment and post-int remenl ofierators. 

7. Post-lncrcmenl Operator, Algorithms use lx)th the pre¬ 
increment and post-increment operators, lhe iterator must 
provide both. 

liEKAioK Stationery 

The iterator stationery provided with this artitiles project files 
(on the Maclech ftp site) gives you a head start in creating your 
own iterators. Most of the functionality of the iterator is provided. 
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You must provkle some haste nuts and bolts to customize it for 
your usL\ [)ut mcjsL i>f the [K>ilcr plate etxle is fiere. 

The stationery is divided into three sections: the class 
definition, the inline functions, and the non-inline functions. 
The class definition will sometimes be changed; you may want 
to include additional constructors or additional routines to 
access information about the iterator. Here is the class 
definition from the stationery: 

claBs Forward!reratdi: 

; public forward_it€rator CType* ptrdiff_t> 

\ 

public: 

// Dcfaulr fousiruftnf. 

// Required by STI.. 

// Can be used as a mait fat the euding puuit ol itmUon 
Forvarditeratqr{); 

// Insert other eunstrutturs here 

// CiOpy cofistnictfH- 
// Retired by STt^ 

Forw^rdltaratort 

const ForwardIterator & inOtiginal ): 

// CumpaiisHHi upcraUir. 

// Required by STL 
bool 

operator™ ( 

const Forwardlterator b InfillSj const; 

//A negaiive coniparision opcmior is also 
// aqulmd by SI L IkiL uUltLy.li indudes a lempbte 
// funcilon that implemenis != in irrms of ==. 

//Assignment operator 
// Required by STL, 

Forwardlterator ir 
operator=( 

const Forwarditerator b tnRHS); 

// [>c[cfcrencc operator 
// Required by STl.. 
connt Type & 
uperatur *() cons t: 

// Indirection operaLor (Optional) 

// IT type 2 strud ur an object then mcliHlc thi» 
const Type * 
operator*)!) eotint; 

// preincrement operator 
// Required by STL 
Forwardlierator 
operator++(); 

// po-stincTement opcrati>r 

// Required by Sn„ Always in terms of preinenement. 

Forwrjr r]I lorn tor 

o p e r a t u r+t {i n t): // T\ic presence of the (int) Indicates 

// postincrement instead of prcincrcmcnl, 


protected: 
Type fType: 

); 


Many of the functions provided by the stationery do not 
liave to 1)C changed, wliilc others must have the code filled in. 
These functions provided by tlie stationery usually do not need 
to be changed: 

inline const Type & 

Forwatditerator;:operator'(J const 

t 

return fType; 

I 
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inline const Type * 

Forwardlterator::operator >() c oust 

I 

return fiiflype: 

) 

inline Forward Iterator 
Forwardit e ratot:;ope rator++(int) 

I 

//ihe post-incrcmcni opcmtor is always Unplcmcntal 
// in terms of the prt-biaTcmaii operator. 

Fotwardltetator temp = ‘‘this; 

-H-f* tills): 
return temp: 

] 

The other functions are discussed in rest of die article. These 
functions often need additional code supplied to cornplete them, 
lb use the stationery you must do a search and replace on 
three strings: 

1. Replace "ForwardIterator'' with the name of your iterator, 

L Replace '^fType'' with the name of the basic storage element of 
the container you are iterating. Tlii.s is the name of a data 
incinbcT of the itemton 

3, Replace 'Type ' widi the type of the basic storage element of 
the container that you are iterating. The iterator will represent 
a pointer to this type. 

Preparing to Write an Iterator 

Before writing an iterator^ there are a few things ahout the 
iterator that well need to know: 

1. I low does it iterate? 

That is, whai eoniaineror list is Ixiing iterated over and how 
do we get the next elenient lk)in the container? This will help us 
to determine the implementation of tlie pre-increment operator, 

2. What is the type (jf the iterator? 

Identify the type that will be returned by the dereference 
operator. 1 his is the fundamental type of the iterator; the iterator 
represents a pointer to this type. 

3. Mow do we compare iterators? 

Does the system or container supply some way of 
identifying e<iualiLy? E{|UiiIity in the sense of an iterator can get a 
little muddy. It is supposed to signify that the two iterators refer 
to die same element in the same container. 

4. How do we recognize the end of the iteration? 

Itds is a special case of comparing iterators. Algorithms 
operate on two iterators; one repre.sendng die beginning and one 
representing die end of the iteration. Algorithms assume that 
iterators can go one past the end. llie end is identified by 
another iterator. Our iterator must have a way nt>l only to 
ciompare to other iterators, but aLso to recognize dial die end of 
the container has been reached, and iteration has occurred. 

Let's look at an example to see what all this means. 


A Process Iterator 

Let's create an iterator that will iterate over the currendy 
running processes. We can think of this as being an iterator for 
the list of processes maintained by the Proce5is Manager. The 
Process Manager gives us an easy way to do this using 
GetNextProcess, In this example, we will aeate an iterator using 
GetNextProcess and we will use a function object to locate a 
.specific process with a signature. 

Let's answer our iterator questions. 

1. How does it iterate? 

The Process Manager provides GetNextProcess, which we 
can use to iterate over the list of processes. 

2. What is the type of die iterator? 

The Process Manager represents processes using a 
ProcessSerialNumber, The iterator will represent a pointer to a 
ProcessSerialNumber, 

3. How do we compare iterators? 

There is only one container cxineerned with prrxresses, and 
that is the list of processes maintained by the Process Maruiger, 
I'herefore, if tlie ProcessSerialNumbers are the same, the iterators 
are the same. ProcessSerialNumbers are compared using the 
SameProcess fund ion [irovided by the Prtx:ess Manager. 

4. How do we recognize the end of the iteration? 

GetNextProcess will return kNoProcess as tlie 
ProcessSerialNumber when the iteration Ls eoinplete. GetNexlProcess 
alst) wants the iteration to Ixrgin at kNoProcess. Therefoie, tliis is a 
circular iterator; tlie l>eginning and the end are the same. 

We .sum by opening the Forwardlterator.h stationery. Replace 
Torwardlterator" with '‘BR.LProcessIterator,'* the name of our 
class. Replace “fType” with “fPSN.” fPSN will hold the pnxess 
serial numlxT of the process we are currently referring to. 
Finally, replace Type” with “ProcessSerialNumber,” the type of 
fPSN as well as the type returned by a few of the functions. 

Restore we review the functions and fill in t!ic code, diere are 
a few constants dial are useluh 

const ProcessSerial Number kBR NoProces.s 
= [ 0, kNoProcess ]; 

const ProcessSerialNinnber kiJR^SysteaiPrucess 
= 10. kSystetnProcess I; 
const ProcessSerialNunibet kBR_CurreritProcess 
* f 0, kCurrentProeess 

This iterator is pretty straightforward and is alniosi a direct 
interface to the 'Ibolbox, Therefore, we are going to implement 
this using all inline funclion.s. To complete die iterator we will 
replace the strings in the Forward I te rate r.cp stationery file and 
copy tliose functions into BR_LProcess Iterator.h. 

'I'he first function to look at is the constructor. Instead of a 
.strict default constructor, we wiD provide a constructor with a 
default parameter. This way, we can iterate over all of the 
processes or begin iterating at some known process. 
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inline 

tocesslterator;:BR^LProcessIterato r{ 
const ProcessSerialKumber & inPSN ) 

: fPSN( inPSN ) 

I 

1 


All we need to do rs initiiilize fPSN. 

Next is the compamon operator. We will build the 
comparison operator in two steps. First, we can map 
SameProcess into a global comparison operator for 
ProcessSerialNumbers. 

inline bool 
operator™ ( 

coni^t ProccssSorialNuraber fit inlJIS* 
const Process Be tialMtiinber & InRHS) 

I 

Boolean sameProeess - false; 

:: SameProcess ( &lnLHS, ^inRHS* fesameProcciJS ); 
return sameProcess: 

1 


'I1iis lets us write die iterator conipariMjn operator 
inline bool 

BR LProcesfiTterator: :operalat”( 

const BR„LProcessitetat(jr & inRHS) const 
I 

returo ( *(‘this) — *lnMS ); 


We have to dereference this twice because this is a pointer 
to an iterator and die tteraior is a pointer to a 
ProcessSerialNumber which means that this is a pointer to a 
pointer to a ProcessSerialNumber. Dereferencing this twice gives 
us a ProcessSerialNumber which can then be compared using the 
global comparLstm operator, 

The dereference operator, indirection operaton and post¬ 
increment operator are all provided by the stationery. 

The last three functions we need to complete the 
process iterator come from the Forwardtteratorep stationery. 
Open the stationery and make the same replacements as we 
did in the Forward I teratorh file: replace “Forward Iterator" with 
“BR^LProcessiterator/ “fType" witli 'fPSN," and “Type" with 
“ProcessSerialNumber/ 

Tile suuionery helps us to fill in the interface to the iterator 
functions, but we need to fill in the irnpirmenlation. 

'I'he first function is the copy consinjaar. Just like the 
default eonstrucfor, we initialize fPSN. 

inline 

BH_LPrqcesslterator::BR_LProcessIterator[ 
const BR.LProcessIterator & InOriginal ) 

: fPSH ( inOriginaKfPSN ) 

I 

\ 


W Stop the press! Late-breaking News II 

We didn’l have time to prepare u glit/y ad so here are ^just the facts": 

AppMaker 

now supports Apple’s Appearance controls. 

These new controls — part of Mac OS 8 and also available for System 7 — make your program 
look belter and also make your code sijnpler. They include bevel buttons, sliders, progress indicators, 
little arrows, tab panels, group boxes, and clock controls. They work in both windows and dialogs. 

Along with the new controls are new Toolbox functions that simplify your code. 

Using AppMaker, it’s fast and easy to create Appearance-savvy applications. 

AppMaker creates resources and generates source code. 

Download a demo from http://members.aol.com/bowersdev. Try it out, then phone for a 
registration number to unlock the demo and make a full working version. Just $199. 
AppMaker includes a 60-day money-back guarantee and a one-year subscription on CD. 

B«0*W*E*R-S 

Development 

P.O. Box 929, Grantham. NH 0375.3 - (60."^) 86.3-0945 • FAX 863-3857 

b6wer«dey#aoi.com • hnj)://meinliers,aol.cuni/bawcrKdev 
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T!ie assignment operator is provitled by the siaiionery. 

The pre-increment opc^rator gets us to the next 
ProcessSerialNumber. We use the Process Manager hjndkm 
GetNextProcess. 

inlitia 

BR^LProfressItetator & 
fltCtiProccss I terator i : opei:ator++ () 

( 

: :CeUJextProcesii{ &fPSN ): 
return *tMs: 

I 

These functions are yill reasonably small, so we can copy 
them from the .cp file into the .h file. We only need to place the 
inline keyword in front of each function definition* 

Use This Iterator In a Sentence 

How can we use tliis iterator to locate a specific process? 
Supjxxse we want to locate the process serial ntimf)er of the Finder 
tt> send it an AppleEvent. The algorithm we want to use is finci_if. 
I’he find_lf algorithm takes two iicmtois, and a function object and 
returns an iterator. This is how we would like to use iu 

const aR_LProcGssTter3tQr t.heEndProtess; 

BR_LP roc es sit e ra t o r tha P r o ce s s: 

theProcess “ find_ift 

++theProcess. 
theEndProcess, 

MyFunctor () ): // What b MyrxinciorO??? 
if ( tbeEndPiocesa theProcess ) 

I 

//llwf liudcT b not numing 

1 

oloo 

( 

//The Finder b niooing 
// tlicPttJccss is the Fimlcr pmct^^ 

\ 

Before we figure out what MyFunctor{) is, we should comment 
on the pre-inenement of ttieProcess in the call to find^if. Kecall thai 
this LS a circular iterator. Ihe iterator Ix^gins l>y pointing to no 
process tkBR_NoProcess). If this iterator Ls incremented, then we 
will Stan at the first pn)cess. find^if expects that the iterator is 
pointing to tlie beginning of the sequence* Therefore, we nec-cl to 
move die pointer to the firsi prcKess by incTcmeiiling it first. 

In STl, terms, MyFunctor() is a unar>* predicate. A predicate^ 
returns Ixxil u^c or false. The unary part means that the 
[predicate will receive a single argumeni* The argument to a 
function object is always the dereferenced value of the iterator. 
Function objects do not opemte on iterators directly. Function 
objctls o[x"rate on whatever the iterator points lo. 

We c'ould write a fumlion that sfxxtfKally comfxines the 
signamre for the ProcessSerialNumber to die signature for the Finder 
or wc could write a more general comparison fumlion and use die 
function object adapter, bind2nd to kx’alc any sixcific signature. 

The function object adapter birKi2nd is used to convert a binary 
nperalion into a unary o|xration. the first aigument is fvassed 
ilmiugli from the algorithm being used. Tlie second value diat is 


passed to the binary opcmior is given to die birxSnd o!:^jett when it 
Ls c:onsinjcted* Here is die Function object dial is irsed widi bind2nd: 

struct ProcessTtf^sSlgnature 

: biiiary_fufictlDn^ Proc^easSerialMuinber i OSType. bool ) 

I 

bool 

operatort)( 

const ProcGSsSerialNuinbGr & iuPSfJ. 

const OSType & inSlgnaturo ) const 

[ 

ProcessInf qRcc Infot 

// inUbliic the fklds of (be proeesLS info 
info*processlnfoLength” slKcofC info ): 
info^processNarae “ 0;//not needed 

Info* p coces sAppSpec ^ 0; // nor needai 

OSErt err - : :tk!tProcosslnfor!iiation( ^inPSN. Slnfo ): 
bool processlIasSJ gnat lire = false: 
if { noErr — err > 

I 

processHasSignature ~ 

( inSignature ^ info.processSignaturc )i 

1 

return proCeSsRnsSigriature: 

1 

i; 

Notice that the function t)l>jcct is a struct. All that means is 
that everything is public* Next, notice that the only item in die 
strucl is a function that implements the function call operator, 
operator(), 'fhe function will get the prexess infiimiation for the 
ProcessSerialNumber and compare the processSignature field to 
the process signature inSignature. 

Here Ls how diis function objea Is used with bind2nd 

const OSType kFinderType ” 'MACS': 

consr BR LProcessIterator theEndProcusa: 

BR^LProccssT tc raror theProcess: 

the Process ( 

t+theProcess* 

theEndProcess. 

bind2nd( 

ProceseHasSlgnatureO, kJ:‘indorType ) ): 
if { ibeKfirfProcfiBs theProcess ) 

I 

//'the Finder is noi nmiiing 

I 

else 

I 

//The Finder b running 
// tbcPniccss Ls the Finder Frucest?* 

I 

bind2nd will pass ihc protrss .serial number given to it by the 
find^if aigoridim and die constant KFinderType to the operatorO 
IcjiRiioii of the ProcessHasSignalure ob)ect, 'fhe 

ProcessHasSignatureO stalement may tfiixjw you at first. This is noi 
a fund ion call. Tliis Ls a constructor that takes no parameters* 
Listing 1 shows the example prognim that first uses a 

process iterator to print a fist of the current running processes. 
Then the Finder pnxess is searched for using find^if and then 
SimpleTexl is searched for using find_if. 
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Listing 1: Process! teratnrxp 

i^lnclude <eti:ing> 
ijfincltide <ioitream> 

#iticlude <Te)ftUtlls*h> 

#1 jiciude "BR^LPrcJc G5S T te rator. h “ 

void 

mainO 

I 

cout << “Citrrftntly running files:” C< endl: 

I 

BR_LP rocessl tei a tor St p, rato r: 

BR^LProcessIteratot und: 
while ( ■H'iterator !” end ) 

I 

processNaue; 

FSSpec procftssSpec; 

ProeesslnfoRGc Info; 

// iniliaJkc iJa- fields i>f the process infij 
info/processInfoLeagtli= siKeof( Info ): 
info.processName "= processName; 

fnfo.processAppSpec “ iprocessSpcc ; 

OSKrr err ” : :GetProcesfiInformatioti( iteraior, Slnro J; 
if t rioKrr err ) 

I 

char 'cstrProceesNatne -- p2catr( ptoeeasName ); 
cout « cstrFrocessNaflie « endl: 

I 

else 

I 

cout C< "An error occured/n"; 

S 

S 

I 

cout i< endl « "Locate the Finder,.." « eudli 

I 

const OSType kFinderType - *MACS': 
const BR_LPcocessIieraLor iheKndProcess; 

BR^ L P r oc e s £11 e ra t or t he? roc es s ; 

theProceas 

" find if{ f+theProcess, theEndProeess, 

blnd?.nd( ProcessHasSignaturet). kFinderTypo ) ): 
if E theEtidProcess = thePtocesa ) 

( 

cout << "The Finder is NOT running." << endl; 

] 

else 

I 

ceut C< "The Finder is running." C< eudl: 

I 

I 

cout « endl « "Locate SiatpleTcxt..." << endl; 


const BTt_LProcLe3aIterat0r theKndProcess: 

BiCLFtocessTte rato r theProcess; 

theProcess 

" find_if{ ++thePtucoss. theEndProcess, 

bind2nd( ProcessliasSignatureO, .‘^igSimpleTeitt ) ); 
if ( theEndProcess = theProcess ) 

1 

cout <C "SiropleText is NOT running." «. endl: 

] 

else 

f 

cout « "SiropleText is running." « endl; 

J 

) 


A Voumre Iterator 

Another list that tran lx; iterated in the Mac OS is the list of 
volumes maintained l>y tlie fiJc system You can think of tlie list 
of volumes as a container that can be iterated. You can iterate 
through the list of volumes, h>r example, to find removable 
volumes or simply to provide a list of available volumes. 

The first step is to answer our questions aixmt how to 
implement the iterator. 

1. How are we iterating? 

Volumes can be iterated by using PBHGetVInfo. The iteration 
is achieved by making sucrcessivc calls to PBHGetVInfo while 
incrementing the ioVolIndex field. 

2. Wliat is the iterator type? 

We will represent a volume with an HParamBlockRec. 
Actualiy, we could use the volurnePafam variaiicjn of the 
HParamBlockRec, but HParamBlockRec is close enough. The 
iterator will l>e a pointer to an HParamBlockRec. 

3. How do we compare iterators? 

Every mounted volume has a different volume reference 
number 'Ilierefore, iterators can be compared by comparing the 
volume reference numlKT in die ioVRefNum field. Just like die 
prtxcss iterator, there is only one contiiiner; die list of volumes 
stored in the file system. 

4. How do you compare to the end? 

Tills is where we have to get aealive. We c’an ifiitiali/.e the 
iterator by setting ioVRefNum to t). A 0 value for ioVRefNum is really 
a logical value representing the system volume, but should not 
iKTCitr during our iteraiiDn. If we use the default constructor as the 
end marker, then we need to similarly represent the end of the 
iteration. Ttierefore, in die pre-increment operator, we will set the 
ioVRefNum field to 0 when there is an enxir. The error indication 
will also prevent us from tntrremcndng an iterator that has already 
l>een completed. Of course, the code is easier than the explanation. 

We liegin by creating the volume iterator in the same way we 
created the pnxxi.ss iieraior. Open the Forwardlteratorh stadonery 
file. Replace "ForwardIteratoY with “BR_LVolumelterator." lliis will 
fie the name of our iierator class. Next, neplacc "fTypa"’ widi iPS.” 
This is the field that holds the current iterated value. We don’t have 
a real cxintaincT so we provide storage for the current item. Finally, 
replace "Type" with "HParamBlockRec." 

Before we get started adding some real code, we are going 
to add a couple of helpful items to this iterator. First, we are 
iterating over volumes. Two useful things we nc^ to know 
alx>ut volumes are the volume reference number and the volume 
name. So we will add two accessors to this iteraTor, 
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//The volume lefercnee number 
Slntia 

VolumeRe fMum() cons t; 

//The volume name <this is an internal poiiuo- rtfencnce 
// rt will change on the next ilaatioiiX 
StrlngFtr 

VolumeName{) const; 


And, due to the way PBHGetVInfo works, we need to provide a 
string to store the volume name. So we add 

Str32 fVoIutneNaiiie; 


to the proteaed seaion of die class. 

Now we can begin filling in the lilanks. The default 
consmictor initializes the volume name and the parameter lilock 
with appropriate values. This iterator is also circular like the 
process iterator We indicate the beginning and end of the 
iteration with the same value. This is indicated in the constructor 
by setting the ioVRefNum field to 0. 

inline 

BS^LVolumcl tera tor: i BR_LVolti]aeIterator C ) 

I 

rVolumeNaiiie [Oj 0: 


I 


f PE. volumcFa ram. loCompl ct Ion 
fFB.volumePa ram.ioReault 
fPB.volumePa ran.ioNamePt r 
f PB. volumeParam. ioVRefNuat 
f PB. volume Pa ram, ioVolIndeic 


' 0 : 

= noErr: 

“ fVolumeNamer 
“ 0: 

= 0 ; 


The comparison operator cannot compare parameter IjIcK'ks, m 
we will aimfyare ioVRefNum fields. Ihe code for the VolumeRefNum 
and VolumeName accessors arc alst) inlined in the header file. 

inline bool 

BR .LVolumeTterator;:operator™( 

const BR__LVolumeIterator & inRHS) const 
I 

return { 

InRHS. fPB.VOlumeParam.ioVRefRum 
““ fPB.volimeParam,ioVRcrNtiin ); 

1 

inline STntIB 

BR_UVolujneItcratort jVoiumeRefNuinO const 
t 

return fPB. volumeParam. ioVRefHuin: 

1 


inline ConstStelS^Param 
BR_LVQlumeIteratar:^VolumeName{) const 
t 

return fVolumeNaroe; 

] 


Tlie 8R_LVolumelterator.cp file rounds out the implementation 
by including the copy constructor, assignment opierator, and the 
pre-incTement operator Ihe copy coastructtir ct)pies the parameter 
block and tlie volume name fields. Also, the volume name potnicr 
in the parameter block must l>e reset to the correct volume name. 

BR_LV<JlumeI terator t: BR_LVolumeI tcrator ( 
const BR_LVolumertoratot k inOrlginal ) 

J fPBt inOrlgitial.fPB ) 

[ 

PLstrcpyC rVolumeName. inOriglnal . fVolumeNaiae )\ 
fPB.volumeParam.ioNamePtr fYolumeNaDie; 

} 


The assignment operator looks pretty much the same as the 
copy constructor First, an in place c^>py Is checked before 
copying the fields. 

BR^LVolumeIterator k 
BlL.LVolumeIterator: :operatoc®C 

const BR^LVoltimelterator & InRHS ) 
f 

if ( this 1= &inRES ) 
i 

fPB - inRliS.fPB; 

fPB.volumeParam.ioNamePtr fVolumeNaiife: 

PLstrcpy( fVoIumeName. inRHS. fVo 3 time Marne 

1 

return ^this: 


The pre-increment operator is the key to the iterator. First, 
check if tlieie was an cm>r We don't want to iterate past the end 
and an error indicates the end. Incrcmcni tlic bVolIndex field and 
call PBGetVInfoSync. tf there was an enor, reset the ioVRefNum field 
to 0 so that tills iierator will compare equal to a default iterator. 

BR_LVoluraeIterator h 

BR_l.Vol uttel ic ra tor:: operatorH- () 

I 

if ( noErr = fPB.volumeFaram.loRoauIt ) 

I 

■H-fPB.volumePa ram.ioVolIndex; 

PBRGetVTnf£>Sync( km )\ 

if { noErr 1= fPB.volumeParam.ioRasult ) 

i 

fPfl, voluineParam.ioVRefMuin = Oj 

1 

return 


That covers it. The example in IJsting 2 shows a simple loop 
walking Through the volumes and printing oui iheir names. 
Similar t:cxle could search for a characteristic of a volume. After 
dial, we use a unary function object or predicate that tests if a 
volume Ls locked and to print a list of locked volumes. This 
example uses a combination of a while kxip and the find_if 
algtiridmi. This i.s a common technique for locating multiple 
items in an iteration dial satisfy certain criteria. 


Listing 2t Volumeltcrator.cp 

lincludG (scririg) 

#ifirludle <lostream> 
tfinclude "BR^LVolnmelterator.h*' 
void 
mainO 
{ 

cont << ^'Mounted Volumes" « eudl: 

I 

BR_LVolumeIterator Iterator; 

const BR_LVolumeIteratDr end: 
while C ++lterator 1“ end ) 
f 

string str( (char *)&( Iterator.VolumeMame()ilj 
iterator. VoltimeManeO [OJ 
cout << str « endl; 

J 

1 

//A unary fuDCtion or picdkatc for tcsiinR rf a volume is locked. 

// if a volume b Uxlccd 
struct VolumeIshocked 

: un3ry_functlou< HFaraniBlockRec, bool > 


42 


The Mac OS, STL, & Iteraiors 


Ma<S'kch • January 1998 










[ 

bool 

operator() ( 

oonat HParamBlockEec & pb ) const 

I 

bool volumeTsLocked = false; 

if t { pb,volunteFaram, ioVAtrb & OxOOSO ) 0 ) 

I 

// Hardware lix:k (tike a CD) 
volume I slocked true; 

] 

else if C C pb.volumeParaiJi*ioVAtrb & 0x8000 ) 1^ 0 ) 

I 

// Si>ftware lock 
volume laLocked Lruc: 

1 

return volumeIslocked: 

) 

): 

cout « endl « “The following volumes are locked" <( endi; 
1 

BR_LVt>luinelLGraLor iiorator: 

const BiL_LVoluffiGlterator end ; 
bool done “ false; 
while ( [done ) 

I 

iterator 

" flnd_if( ++1terator. end, VolumelsLooked() }: 
done ” ( iterator — ond ); 

If [ Idotie ) 

I 

string str((char ') ^(iterator. VolumeNanie C} [1]} * 
iterator ,VolmiieNaiiie{) [01 ); 
coijt (< str << endl: 

1 


1 


A File Itekator 

The last example iterator is a file iterator. I’his iterator will 
iterate over all of the files in a given folder. We must an.swer a 
few tiuesiion.s about the iteralf>r before we gel started. 

1. How are we iterating? 

We can iterate over files in a folder by using PBGetCatInfo, 

2. Wliat is the iterator tytxj? 

PBGetCatInfo uses a CInfoPBRec to iterate over the files. 
H(>wever, FSSpecs are easier to use in other Toolbox calls. A 
ClinfoPBRec will be used inlcrnally, but an FSSpec will he 
used externally. 

3. How do we compare iterators? 

Iterators are equal if their ioVRefNum, ioDirlD, and ioFDirlndox 
fields are the same. That is, if they are referring to the same 
volume, the same directory, and the same indexed file. The 
volume and directory represent the container, while the file 
represents the element in the container. 
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We begin constructing the iterator the same way. The name 
of the iterator is BR_LFilelterator. The name of ilic iteration field 
is fSpec and its type is FSSpec. Three Kcplace“Airs and we are 
most of the way there. 

First, add a couple of constructors that are pretty useful: 

// Construct from an FSSpec 

// Note the use of explicit. I'liis constructor b not a type coiivcncr. 
explicit 

BR LFllelteratorC 

const FSSpe^c h inFolctdrSpec) : 

// (kinstnict from vRcfNum and DiriO 
BH_t4Filel Leriitor ( 

short Inii'olderVRGfNuni, 
long inFolderDirlB); 

The underlying impleinentation uses a CInfoPBRec and we might 
want to use it in other places so: 

// Oct accevs CO the ClnkiPBRcc. 
const CInfoPBRec & 

GfltCTnfoPRRGct void ) cotifjt; 


4. How do we recognize the end? 

'the ioFDirindex field is initialized to 0 and incremented thmugh 
the files. When an error such as iterating f)ast tlie last file occurs, llic 
toFDirlndex field is reset to 0. A special case in the compaiison 
operator is to check for the ioFDirindex fields boxh being equal to 0, 


Finally, add the parameter block: 

CInfoPBRec fPB; 

Next, fill in the inline functions in the header file. The 
default constructor turns out to be a bit too much to lie efficient 
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inline, so it should be moved into BR_LFilelterator,cp after we 
create it from the stationeFy file. Likewise, the other constmaors 
will also l>e iniplctncnted in 0R_LFilelteratOLCp. 

llie only function to fiU in here is the comparison operator; 
the other functions work just fine from the stationery file, 'Lhe 
comparison operator kxjks iikc: 

Inline? bool 

BR^LFllelteiator;:opetator—( 

const BR_LFiieIterator SinRHS) const 

( 

// If both indexo ak 0 then tlit-se m: equid^llie only time 
// an index h zero is at the beginning or the end of an itcratHjn. 
bool equal = 

( inRHS.fPB.hFileTnfo.ioFDirtndex ” 0 ) 

&61 ( fPB.hFilelnfo*ioFDirindex = 0 ): 

if ( 1 equal ) 

( 

// Otherwise all three of index, directory, and vRefNum 
// must be equal 
equal = 

( InRRS,fPB,hFiIcInf 0 .ioFDicIndex 
= fPB*hFilelnfo-ioFMrlndex ) 

( inRHS.fFB,hFilelnfo.ioDirlD 
“ fPB,hFileInfo,ioDirID ) 
InRHS.fPB.hFilelnfo.ioVRefl^uin 
= fPB-hFllelnfo.ioVRefNum ); 

I 

return ( equal }: 


Tliis is a liltle complicated, but noL overly so. First, check 
for the index values being 0, The only time the index values are 
zem is before the beginning or after the end of the iteration. We 
treat these points the same, so if both indexes are zero, then the 
iterators are equal. 

Otherwise, we compare the index, direaory II), and the 
volume reference numbers all for equality. If they are aE equal 
then the itcraLors arc also equal. 

Next, create BR_LFIIeltefator.cp. Begin by opening tlie 
Forwardlterator.cp stationery file. Make the same replacements 
here as wc did in the header file: “ForwardIterator" is 
"BR_LForwardlterator,” “fType' is “fSpec,” and "Type” is "FSSpec." 

llie first three functions are constRictors. Ihey each just set 
default values for fields or copy the relevant fields from the semree. 
The default eonsirucior initialLces llie relevant fields to zeros. 

BK_lFileTterator:jBRJ.FileTterator() 

I 

f Spec . vRefWuni = 0; 
fSpec.parlD = 0 : 
fSpec.name to] “ 0 : 

fPB.hFilelnfo.ioCompletioti ^ 0; 
fPB. hFll eTnfo. i oResul r. = noErr; 

rPB.bFllcTuro, ioNamePir ^ fSpec.natne; 

fFB .bPilelnfo .loVRefWuiD ” 0: 

fPB.hFileinfo*ioFDirindex = 0: 

fPB.hFileInfo.ioDirlD - 0: 


'I'he copy constructor copies the structures wholesale, and 
then fixes the ioNamePtr field in the parameter block to point to 
the correct FSSpec, 

BK_lFlleTterator:;BR_LF1leiteratort 
const BR^LFileiterator &InOrlglnal J 
: fSpec( inOriginal.fSpec )* 
fPB( inOriginal.fPB ) 


// Fix the ioNsmePir fickl in I lie panimelcr block. 
fPB.hFiielnfo.ioNamePti: = f Spec,name; 


ITie constmaor from a volume reference number and 
directory ID jusl use the values to initialize the FSSpec and 
parameter block fields. 

ER LFilelteratot::BR LFilelteratot( 
short inFol derVRefNum, 
long inFolderDlrlD) 
f 

fSpec . vRefNum = inFolderVRefNooi; 
fSpec.parlD = inFoiderDirlD; 
fSpec*nante[Ol = 0: 

fPB .hFllelnfo. ioCofiipletion = 0: 
fPB.hFilelafo.loResulL = noErr; 
fPB.hFileInfo,ioNaniePtr = f Spec, name: 
fPB.hFilelnfo^ioVKefNoni = fSpec . vRefRum; 

fPB.hFiieInfo.ioFDirIndex ^ 0: 
fPB.hFileInfo.ioDirlD => fSpec.parlD; 


Constructing from an FSSpec is a little more complicated. If 
the FSSpec is for a folder, then we need its directory ID. If the 
FSSpec is to a file, then we needs its parent direaory ID. First, 
initialize the parameter block and FSSpec fields. Then call 
PBGetCatInfoSync. Checking ilie ioFlAttrib field tells us whether 
the result is a directory or a file. We can then initialize the parlD 
field of the FSSpec with the correct field value. 

BR_LFileIte]:atoi:: :BR_LFlieltei:ator[ 
const FSSpec & inFolderSpec) 

I 

// Copy the fj^^pec into our FSSpec. 
f Spec . vRcfNutJi “ inFo Idc rSpcc. vRofNuin; 
fSpec.parlD ^ inFolderSpec.parlD; 

PLstrcpy( fSpec.name. inFalderSpec^name ); 

// JjiiUaJtzc lilt fitltls of lilt punuiiticr block 
fPB.hFilelnfo.ioCompletion = 0: 
fPB.KFllelnfo.ioNamePtr = fSpec.name; 

fPB.hFtlelnf 0 . ioVRefNum - fSpec. vRefHtim; 

fPB.hFlIeTnfo.loFDirTndex = Q; 

fPB.hFilelnfo.ioDirlb = fSpec.parlD; 

// Go ihc info for tlic FSSpec. 

// 

// If ihf l^SSpcc a folder ihcn the foDrOirll) field is 
// Lht diiitciory ID of that folder and tiiis will htrait filti; 

// in that direttoir. 

// 

// If lht FSSpec was to a file, then the loFll^rlD field 
// is the directory ID of llie pareot directory and this will 
// iieniic files in that directory. 

// 

// Maiolain the directory id in the parlD field of Ihe FSSpec. 

// PBfktf^atlnld will over write the value, so it must bt' restored 
// licfore each call. See iJperati>r+40 
OSErr err " ;:PBGolCatTnfoSynci{ fcfPB ); 
bool isDlroctory 

= ( fPB.hFileinfo.ioFlAttrib & ] [= 0: 

fSpec.parlD = isDirectory ? 

fPB.dirlnfo.ioDtbitlD : fPB.hFiielnfo.ioFiPacID: 


'The assignment operator is straightforward. Instead of a>pying 
tile sLructLinc.s wholesale, well t>nly copy the fields wc need. W 
must remember to set the ioNamePtr field appropriiuely. 

BR LFileTterator fii 

BR_LFiloTterator::operator^[ 

const BR„LFiloIlorator &inRRS ) 
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if ( this SinRHS ] 

I 

// (>)py the FSSpec 

fSpec. vRenJuir “ InRHS. rSp<^e, vRefNuJii; 
fSpec*parID = inRJiS . fSpec ,parl0: 
;:FLstrcpy( fSpec,name* inRHS*fSpec,name ): 
// G)py the paranieier block We only care abcjoL 6 fields, 
fPB.hFileInfo.ioCompletion = 0; 
fPE,hFileInfo*ioResult 

= inRHS.fPB.hFileTnfo.1oRcsult: 
fPB,hFneInro*ioNaiticPLr 
fSpec .name; 

f Pli. liFil e inf 0 * InVRef Num 

= ItiRKS. fPB . hFiieInfo. ioVRefNum; 
fPB.hFileInfo*ioFRirlndex 

“ iTiRHS*fPB.hFileInfo,ioFDirIndex: 
fPa.hFileInfo.ioDirTD 

- InRHS* rPB/hFilcInfQ.ioDlrll}: 
t 

return ‘this: 


Finally, the rt;al iteration part of the iterator, the pre- 
incfeiiieiit operator: 

BR LFilelterator i 
BR.I.FiloTteraLor::operaLor++() 
t 

// Only iDcrcmciil if liictv Ls [lo error 
If ( noErr = fPB,hFileInfo,ioResiilt ) 

( 

iffFB*hFileInf 0 .ioFDi rIndex: // incranem the index 

fPB.hFileTnfo.ioDi rTD - fSpcc*parID: y/osc fhc correct dir ID 
OSErr orr " : :FBGcLCaLlijfoSyiic ( &fPB ): 
if { noEtr 1= err ) 

[ 

// Reset die index to mditale that we arc Ui>ne. 
fPB.hFileInfo.ioFBitIndex = 0: 

} 

I 

rGfurn *thta: 


First, irtake sure tliat lliere has not been an error Then we 
increiTieiit tlie index. We also need to copy die direclory ID field, 
7Tii,s field is an 10 field tor PBGetCatInfoSync so we must reset it 
[xrfore each calf Next, c:all PBGetCatInfoSync. IF an error ocairs, we 
reset die index to :iero to indicate diat we arc^ done. 

that completers our file iterator. Tliis iterator can iterate over 
any folder returning all of the files and folders in that folder. Shown 
in Listing 3 is an cxaniple program that uses a simple while loop to 
iterate over all of the files in tlie System Folder. 

After that, we use a function object called FSSpecIsType to 
l(K:aLe all of the 1NIT’ file,s in the extension folder. *lhis ejcample 
also uses a combination of a wliile Icxip and the findjf algorithm 
as we did in the volume iterator exanipie. Tliis is a common 
technique for locating multiple items in an iteration that satisfy 
certain criteria. If we needed the list of 1NIT’ files to be pei^sistent, 
we could use remove_copy_if and a vector of FSSpecs. 


Listing 3: Fllelteratof^cp 

^finclLEdc <Folderi;*ii> 

^include **BR_LFileIterator. h"* 

void 

mainO 

I 

short vRefNiim ” 0; 
lang dirTn - 0; 


FlndFolfier { 

kOnSystemDiigk. kSystetnFoldecType* kDontCreateFolder, 
^(vRGfNuni* &dirlD j ; 

fi R_LF11 e 11 e t at £> r e nd: // just a defaiiti niaiker 
BR_LFileIterator iterator( vRefKum, dirIB ): 
eout « "List the file^ in the Ryatera foldRr\n'"t 
while ( Hiterator end ) 

[ 

■?trin^ Str( 

(chai i(iterator->naine [1]), iterator->name [Q| ) ; 
cout « str << endl: 

1 

cout « "List the IKTTs in the extension folder\n‘': 

// Define a binary hinction that testi 
// the file type of an FSSpec. 
struct FSSpecIsType 

: hlnary_f uiiction< FSSpec * OSType* bool ) 

I 

bool 

operatorO [ 

const FSSpec & inSpec* 
ennst OSType £r inType ) const 
t 

bool isTypa = false: 

Flnfo flnfo: 

OSErr err - FSpGetFInfoC &inSpec* iflnfo }: 
if ( noErr = err ) 
t 

I slype = i inType flnfo* ftIType ): 

] 

teLurn isType: 

I 

S; 

FindFolder( 

kOnSystemElsk. kExtensionFolderType. knontGreatcFolder* 
^vRefNum* firdirTD ): 

FSSpec exiensionFolder: 

FSMakeFSSpec { vRefl^mn, dirlD* Q, fitextensionFoider ): 
BR_LFilelteratpr extIteratotC extensicnFolder ): 
booi done = false; 
while ( “done ) 
i 

nxTIterator " ririd_ll( t+extltecator* end, 
bind?.nd( FSSpecIsType [}* *IN1T' ) ): 
done = ( extlterator = end ): 
if ( Idone ) 

f 

string str[ 

(char ♦)&{extTterator >name[l])* 
cxtlteraLor >naiiie [0] ); 
eoUL « sLr << endli 

1 

I 

1 


Coinclusion 

We hope that you have learned how you can take advantage 
of the Standard Template library to easily find inlbrmation and 
iterate over itenis in the Mac OS, There are many other iterators 
that can be created. Some ideas are to iterate over items in an 
AppleFvent list, extend the file iterator to iterate over folder 
hierarchies, or iterate over the items in a resource list such as a 
string list CSTR#') resource. We are sure you will come across 
many other examples of iterators in your programming, Tlic 
stationery files and the techniques described here should help 
you to coastruet iterators for your applications. B1 
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by Guillaume Bedard, Frederic Leblanc, Yohan Flourde and Pierre Marchand, Quebec, Canada 


Fast Square Root Calculation 


Optimizing PowerPC 
Assembler Code to beat 
the Toolbox 

Introduction 

Mile caiculation of ihe M|Liare rcxit tif a 
floating-point numl>er is a frequently 
cncounicTccl task. However, the PowerPC 
processors don’t have a square root 
instruction. The implemenlalion presented 
here p<Tforms llic .s(|Uiire rtK>t of a doubie- 
(ireeision numlier over the full range of 
representation of the Ihhh 754 stantbircl for 
normalized nunilx‘rs (from 2.2250738585lE- 
308 lo 1797693i.3486E508) with an 
accuracy of 15 or more tledma! digits. It is 
very fust, at leasi six times faster than the 
M<x>lhox HQM dlL 


Sign 


.r Pf I 02 :: 


/ 


1 l*bH biased 52-bit fraction 

exponent 


For example, the numlxrr 5-0 can lie expressed in binary as 
101.f), wliich means 101.0 x 2^, which in turn is etjual to 1.010 x 
2^, obtained by dividing ihe mantissa by 4 and multiplying 2^ by 
4. 'rherefore, the normalized maniissu is 1.010 and the exponent 
2. Fruciion / is then .QHKKKKK)..The biased exponent is 
obtained by adding 1023 to e and is 1025, or lOOOOOOOOOl in 
i>inaiy. The double precision lERK representation c:>f 5.0 is finally: 

or 40140000tXKJCK)(K)0 in ht:xadecimaJ notation for short. 


Theory of Operation 
A floating point number has three 
components: a sign, a tnantksa and an 
cx|xmential pan. Far examf>le, the numix-r 
+3.5 X ItF* (35 000) has a plus sign, a 
mantissa of 3 5 and an exponential part of 
lOT The mantisHii consists of an integer 
part and a Imctional part / 

A double precision number in tFEH 754 
form;il has the same components: a sign bit 
s, an 11-bii exponent e and a 52 bit fraction 
/. Tile exponential part Is expressed tn 
powers of 2 and the exptment is hki'^^d by 
adding 1023 to the value of e. T!ie mantissa 
is normalized to be of the form 1/ Since 
the integer part of the normalized mantissa 
is always 1, it dciesnM have Lo lx: included 
in the ret>reseniaiiorL Tlie numlxT is thus 
represented as follows: (-ly 


First Approximation 

Given this representation, a first apprt)ximation to the square 
rexM of a number Is obtained by dividing the exjionent by 2. If 
the niiml>er is an even power of 2 such as l6 or 64, the exact 
nxrt is oiiiained. If the numl^er is an odd power of 2 such as 8 
or 32, 1 W 2 times the sc^uare root is oixained. In general, the 
result will within a factor ^2 of ihe true value. 

KEEININCp the APPROXJMAriON 
M1ie Newton-Raphson met lux! is often used lo obtain a more 
accurate value for ific rtxrt x of a function /x) oncx^ an initial 
approximation is given: 

[H 


w 


Tlie first ihr^ authors are undergraduate students in Computer Science at Universite I^val in Quel^, Canada. This work was 
done as an assignment in a course on Computer Andiitecture given by the fourth author. 
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This becomes, in the case of the square root of n, = - 

n:where /jc) 



An excellent approximation to the square root starting with the 
initial approximation given above is cAtained within 5 iterations 
using equation I2l This algorithm is already pretty fast, but its 
speed is limited by the tact that each iteration requires a double¬ 
precision division which Ls the slowest PowerPC floating-point 
instruction with 32 cycles on the MPC601 (Motorola, 1993). 


EliMLNAllNG DIVISIONS 

Another approach is to use equation 111 with the function. 



1 

n' 


In this case, equation [1] Ix^comes: 

[31 

Tliere is still a division by n, l>ut since n is constant (it's the 
origimil numl->er whose tool we want to find), it can be replaced 
by multiplying by l/n, which can be calculated once before the 
Ixginning of llic ileralion piiK:ess. The five 32-cycle divisions are 
thus replaced by this single division followed by 5 much faster 
multiplications (5 cycles each). This approach is approximately 
three times faster than the prec^eding one. However, care must lx? 
taken for large nuinlxrs sincre the term in can c:ause the 
operation to overflow, 


USli OF A TABLE 

Finally, an approach tliat is even faster consists in using a 
table to obtain a more accurate first approximation. In order to 
do so, the range of possible values of fraction / (0 to "-I) is 
divided into 16 .sul>-ranges t)y using the first 4 bits of/as an 
index into a table which contains die first two cfxfficienLs of the 
Taylor expansion of the .square root of the mantissa (LO to ^2) 
fwcT tliat sub-range. 


[4] 


The Taylor expansion is given in general by: 

+ r(^(x- xq ) + ... 


the first two terms of which yield, in the case where /x) = 

-Z%- - T*-S^* 


The square rtrot of x is thus approximatetl by l6 straight-line 
segments. The table therefore contains tlic values of 


VAb 

A = 2 


1 

andtf= 

for each of the 16 suli-ranges as shown in Figure 1. This first 
approximation gives an accuracy of a!K>ut 1.5 %. 



-j. ---^ jf 

^0 


L Appraxim^ition t^^siraighl line st^merii. 

To reach the desired accuracy of 15 digits, equation 121 is 
applied twice to die result of et|uaiion 151. To avoid having to 
perforin two divisions by repeating the iteration, die two 
iterations are folded together as follows, which contains only 
one division: 


and 

161 


^ fv'i + 


In order to perform these calculation, the exponent of Jcand 
n Is reduced to -1 (1022 Imsed), m) that floating-point operations 
apply only to the values of the mantissa and don't overflow if die 
exponent is very large. The value of these numl:)ers will therefore 
1)0 in die range 0.5 to 1.0 since the mantissa is in the range 1.0 
to 2.0. If the original expuncTit was txld, die manLi.ssa is 
multiplied by V 2 l^efore applying equation 161, 

Finally, the original exponent dividecl by two is restored at 
the end. 
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Till Code 

The SQRfKsI funaiDn shown in Listing 1 has been 
irnplemcnicd in Code Warrior C/C++ version 10 * 


Listing 1: SQR<K>t*c 


// Ofi entry, (j>l ctmUijei a ptisitive number between 
// and J 797n931On exit, the nKiull b in ^ 1. 

asm long double SQUootClong double num): //prototype 

float Table[351 “ ( 

(],353553390593, 0.707106781187, 0.364434493428, 0.685994340570, 
0.375000000000, 0.666666666667, 0.3B5275B75186, 0.648885684523, 
0.395284707521, 0,632455532034, 0.405046293650, 0.617213399848, 
0,414578098;94, 0,603022689156, 0.423B95623945, 0.58976782462Q, 
0.433012701892, 0,57/350269190, 0.441941738242, 0.565685424949, 
0.450693909433, 0,554700196225, 0.459279326772. 0,54433]053952, 
0.467707173347, 0,534522483825, 0.475985819116, 0.525225731439, 
0.484122918276* 0.516397779494* 0-492125492126. 0.508000508001, 
1,414213562373, 0,000000000000, 0,000000000000 h 


asm long double SqrtClorjg double num] [ 


Iwz r3.Table(rtoc L 

Ibz r4,24(ip3 

andi, r5,r4,0KF 
orl r5,r5.0x3FKO 
eth i:5.24(sp) 

riwinro r5 ,r5*3,25.28 
Ifd fpl,24(ep) 

Ifsux fp4,t5.r3 
Ifs fp5,4(r5) 

IfE fp3,12&(r3) 
fmr fp2,fpl 
rlvinia, r5 ,r4,31.18,28 
beq ^2 


// address cifTabIcfl 
Z/luad 

// Siynf i HbiponoiK 11 
// keep only Mantissa(4) 

// exptHicnt - -I +BIAS - 1022 
// save reduced number 

// take 3'Mantis5a(4) as Imlex 
// load reduced tiuiubcr 
// load coelTicieTU A 
// load cuefGeient B 
// lead SQftT(2) 

// ci^y reduced number 
// di^e exponent by 2 
// if (exponent O) rhen done 


fmadd f p2. f p2 . f p5 . fp4 // appmxtttiMlioti St^R'lXx) = A + B*x 
and i, r4 * r 4.0 x 10 // chedt if cxp< inent even 

beq //if (oponeiit even) da iteratitm 

fmul fp2 , fp2 . f p3 // mtihiply reduced nitmher by SQRT(2) 

fadd f p 1, f p 1, f pi // adiust exponent of oiigiml number 


mi: faddfp3,fp2,fp2 //Z’s 

fmul fp5,fp2.fpl //x'n 

fadd fp3.fp3.fp3 //4*x 

fmadd fp4. fp2. fp2, fpl //x-x + n 
fuu 1 fp 5, fp3. f p5 // 

fBUl f p 6, f p2, f p4 // denumiiiatur = x*(x*x + n) 

fmadd f p5 . f p4 . fp4, fp5 // nunicrator = (x‘x + n)*{x*K + n) + 
// 4*x’x’n 

fd 1V fpl, fp5 . fp6 // double precision division 

a rid 1, c5 ♦ r 5. Ox 7FFO // mask exponent 
addl rb, r5 , Oxlf EO // rectify new exponent 


rS,132Cr3) 
Ifd fp2.132(r3) 
fmiil fpl ,fpl, fp2 
bl r 

1 


// save constant C (power of 2) 

// load constant C 

// multiply by C to replace exporieni 
// done, the result is in fp 1 


Performance 

The code presented above mm in less than K)0 cycles, 
which means [es.s than 1 micrtxsccond on a 7200/75 Power 
MacinUJsh and is more than six times faster than the ROM ctxie. 
The code could l>e modified to make use of the Jlrniing 
reciprocal square roof estimate in.sirucii()n (frstirte) that is 
available on the MPC603 and MI’C604 processors, and which has 
an accuracy of 5 bits. It is not available on the MPC60!, however. 
The method used here could also be iisetl to evaktale other 
transcendental functions. 


Performance was mea.siired by ninning the axle a tliousand 
times and calling a .simple timing routine ftiimd in (Motorola, 
1993), that wc called myGetTimeO^ It uses the real-time clock of 
tlie MPC 601 processor (R7’Cli and RTCL registers) and is shown 
in Listing 2. 4'he routine woukl have to lx.‘ nitxiified to run on 
MPC603 or MPC601 prix.essors, since they don't have the same 
real-time clock mechanism. 

The code doesn’t supp<3n (lenormali/.ed numiiers (below 
2.225073J^5851K-308). Tfiis could ca.sily be implemented allieit at 
die cost of a slight reduction in performance. 


Listing 2: myGetTime.c 

aesi long myGetTlnteO 


// R ICtJ 
// RTCL 
//RTaJ wii 

// if RTO f h3.s chxnpxl. try iigxin 


Ip: mfspr r4.4 
mfRpr r3x5 
mfspr r5,4 
empw r4,r5 

bne Ip 

rIwinm r3 * r3.2 5, / , 31 // shift nigh* sintr bits 25*31 ate 
// not used 

blr // the result is in r^. \ unit b 

// worth 128 rei, 

I 


'lb am the ctxlc, a very simple interface using the SIOUX 
library is provided in Listing 3. 


Listing 3= niatn,c 


^include <Etdfo.h> 
ifinclude <stdllb.h) 
Jinciude <etring,h> 
jinclude <fp,li> 


vu 1 d ma I u 0 

t 

long doubl^num, numZ: 

long startTiiDG, endTime, time: 

short i: 


do [ 

printr(*'%2s"*"> '’); 
sesnf ("%Lf ; 

if (num < d-O) num 0.0; 
startTime = myCetTiiaeO ; 
for (i - 0; i < 1000: i++J 
nura2 ” SQRootfnum]; 
endTime = nyG«?tTitiie(): 

Lime - GridTlme RTarTTiroi>; 
if (num > le 6 65i ruim < le/} 
priutt (“17s%Lf\n" ,"^01 ” 
els@ 

printfC"%7a%Le\n” *"root “ “,nura 2 j; 
printf(''1L7s%d\n*\"time “ time): 

I 

while (1); 

I 


//conn 

// read king d^iuhlc: 

// replat'c by 0.0 if negative 

// repeal 11X10 rimes 
// call our functitm 


ptiUinZ); //show rc^iul! 


// sliuw dajmxl lime 
// repeat luitil Quji 


References 

PowerPC 601 RISC Microproces,sor User'.s Manual, Motorola 

MPC60HJM/AD Rev I, IWi. B 
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Code Warrior Latitude: 

Porting Your Apps to Rhapsody 


AA 


metrowerks 


llie June, 1997 fackjry FlcK>r column 
contained an interview with David 
Hemplinf», CodeWarrior Latitude engine¬ 
ering lead. You can find the interv'tew at: 
<http://v\ArtAA/.metrowerksxom/products/cw/Iati 
tude/index.html>. 

For those who missed the 
interview^ Code Warrior Latitude is 
essentially a porting library that greatly 
simplifies the pmeess of porting 
MacOS applications to Khapsody, 
Latitude is an implemenlation of the 
Macintosh System 7 upplication 
programming interfaces (APIs) that 
allow's source code for a Macintpsii 
application to be compiled with little 
modification on a Riiapstxly platform, 
resulting in a native Rliapsody 
application. Latitude maps the Mac API 
requests to native Unix .system calls. 
An application built with Latitude 
attains the look and feel of the new 
native platform. In this column well 
explore the process of using Utimde 
to port applications to Riiapsody. 

A SiMPiJ^ Examp[.f 

Let’s start off widi a simple example, 
straight from the pages of the Mac Primer, 
Volume IL ColorTutor allows you to play 
with the various Color Quickdraw dniwing 
mtxles. Written in C, ColorTutor comiLsLs of 
a pit^jjcci file, a C source file, and a resource 
tile containing MENU & WIND resources. 

The first task in potting an application 
to Rhaps^xly is to physically get Uic 
application's files to the Rhaposdy 
platform, there are several ways to do this. 
For the source code itself, any means of 
transferring text files from one computer to 
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anotlier will do. If we had a collection of sources, we could tar 
them up with a tar tool on the Mac, ftp the tar file to Rhapsody 
with something like Fetch, and untar die itiiage on the other side. 
Tills [iictltcxi cannoi be ustxl to transfer Mac resource data. 

Another method would lx* to use one of several available 
UNTX/Mac file sharing systems such as Mac NFS, NFS/Share, I FI' 
uSliare, Helios EtherShare, or Xinet K-AShare, Latitude's File 
Manager undeistands the various formats that these systems use 
so they are also good for traasferring Mac resource data. 

Before copying over the resource file, liowever, we mast 
ensure that a BNDL resourt'e is present in the application's 
resource tiata. Lititude requires the signature value in an 
a[)plit:ation's BNDL resource in order to maintain its own 
^'desktop dataliase*'. Colofl'utor.rsrc does not tiave a BNDL 
resource so we'll add one, using ResKdit, on the Mac. We'll make 
ColorTutor's signature 'CTTR*. Tliat done, well build Colorfutor 
on tile Mac*, ensuring tliai all of the application's resourc:es are 
collected into the applic:atit>n's executable. 

For this example, we use NFS/Share to transfer the 
ColorTutor executable to our target platfoTin. NFS/Share uses 
Ap[)leDouble format, so the file will be split into two pieces 
when it is transferred, namely ColorTutor and ^KiColorTutor. 

Once we’ve successfully iraasfciTed the file to our Uhapsexfy 
file system, we place %ColorTulor in a directory named- 

$LAT I TUBE. ROOT /La 11 tiid e. Hn c R i I e a / Ap pi i cat! on a / Co i 0 rXut or/ 

$LA'nTlIDE_ROOT is where Latitude was installed on our 
Idiapsody system. We place CoiorTutor.c in the directory: 

$LATITUDli_ROOT/Latitude.MacFiles/AppUcat ions/ 

ColorTutor/Sources/ 

We t:an now prepare the CoiorTutor.c file for compilation. 
Uititude includes a tool t:alled prepare_sources that traverses 
your source files and replace.s non-ANSI Mac-isms in your 
sourcres (such as pascal strings, cight-i>ii characters, and four 
character constants) with macros that conditionally expand to 
either the Macintash or die ANSI .styles, depending on where the 
build lakes place. It also creates a Makefile usable with gnu make 
that can Ijc used to build your application. 
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prepare_sources wanbs to know the name of the application 
we're creating and the type of system includes it is using: 

X prepare_sources ColarTutor universal 
Creating Latitude,inanifest,,, 

Converting source files to Latitude files. 
macZunlK: processing ,/ColorTutor,c 
Writing default Makefile,,. 

Conversion complete. 


QjlorTutorc is copied to ColorTutor.c.bak, preserving the 
original code, and three files are created: the modified source 
ColorTutor.c, a Makefile, and Laiitude.Manifest, which is a list of 
The source files used to create the application. 

Looking at ColorTutorx, we can see that prepare_sources 
replaced ail strings with PSTRINGCONS'rC‘*^F.”) macros. It 

also replaced four-charaaer constants like 'DRVR' with the 
QUADCONST(*D'/RVV'/R') macro. Even though some non-Mac 
compilers will handle a four character constant, the order of the 
chameters in the resulting long can be flipped. By using 
QUADCONSTO, we ensure that the proper ordering is achieved. 
When compiled on the Mac, QiIorTutor.c relied on the 
Mad leaders pre-compiled headers, Since we don’t have pre¬ 
compiled headers on our non-Mac platform Cyei), we must 
explicitly include Mad leaders in our .source, A copy of the 
standard MacHeaders is included in $lJVTTnJDE_ROOf ‘/utilities, 
so we'll copy it to f)ur Q>k)rTulor/Sources and ^include it at the 
top of CoiorTulor.c 

ColorTutor.c uses qd. to access Quickdraw low memory 
glol>als like the Port, screen Bits^ etc. Code Warrior Latitude 
supports these globals but does not keep them in a qd structure. 
We can use a macro to remove qd. when it Is used. At the lop of 
ColorTutor.c, we add the following: 

.UTITUDE. 

^define QD(x)x 

#define qD(K)qd.x 
#endtf 


We now go tlirough Colorfutor.c and replace instances of 
tjd. wilJi the use of the QDO macro. So 

InitGraft itqd.thePgrt }; 


becomes 

InitGraf (&QDttliePorT}): 

There are a few other instances in tlie file which we'll 
replace as well. 

Before we build ColorTutor, we mu.st insert code to initialize 
Latitude. The lg_latitud©_init() c'all docs several things. U sets up 
Latitude's trap Table, initializes various toolbox manageni, and 
open.s latitude's System file and the application's resource file. 
IgJatiludeJnitO also allows settings that affect how the 
application looks and behaves. For Coloflutor, only the bare 
minimum is retjuired. 
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Currently, mainO out like this: 

void stain' void ] 

I 

ToolboxTnit 0 : 

HenuEarTnit0 J 

We’re going to change mainO to accept aiguments and pass 
those arguments to lg_tatitude_init: 

#ifndef _UTITUDE_ 
void stain( void ) 

I 

void maln( long ar^c. char ‘‘argv ) 

1 

jlfdef ^UTITUBE. 

LC_APP_INFO_BLQCK Iblock: 

Iblock.flagG - LG APF^ItfFO_STGNATURE | 

LG APP INFO CUSSNAMKi 

lbTock,el£nature - QUADCOHSTt ’T', T\’R’); 

1 block,classnaroe ■ "Latit^ide"; 
l&_latittide_init (arge * argv. tibloclt): 

#endif 

TooiboxInitO; 

HenuEarTnit0 ; 

We're now ready to build ColorTuior. Using the gcc 2.7.2 
ctjmpiler, this code compiles without error. However, if you're 
using a different C compiler, you may find that the C++ style *//’ 
comments at the top of CoiorTutor.c are a problem. If so, simply 
replace them with C style '/* V comments and rebuild. 

The first time we run ColorTucor, Latitude brings up a Get 
File Dialog asking us to locate the application’s resriurce Rle. This 
is only done once. Latitude stores the location of the rc.source file 
in it’s own desktop database located at: 

MBer,HflcFiles/Sy©toiii/Prcfercnces/LatltijdeApps 

Ont:e that is clone, ColorTutor is off and running on our 
platform. Playing wiiii die app's popup menus and seeing the 
proper results in the dialog shows diat iliLs applieaiion was 
ported succe,ssfully with very litde effort. Additionally, we can 
lake ifiis source code back to the Mac; along with the 
LGLatitude.h file, and continue lo use the same source to build 
Ixith our Mac and non-Mac platform versions. 

PowerPlant 

Obviously, ColorTutor is a very simple application that 
doesn’t contain any serious ponability problems. It’s ANSI C 
ccxle, contains no private resource data that it uses itself, doesn’t 
patch traps, doesn't liave custom definition functions, etc, Ijets 
move on to a more complex porting example and look ai what's 
required to bring a PowerPlant app, like Muscle, over to 
Rhapsody using CodeWarrior Latitude. 

The first thing to notice alxjul PowerPlant is dial it's written 
in C++ and that its source code is laid out hierarchically in a 
directory structure. It's easy to replic:aie this structure on our new 
platform. The prepare_sources scrijjt currendy only recogni^^es 
file extensions for C (.c ik .h). It is easy to modify the Tind' 
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incantation in prepare_sources to recognise die C++ fde naming 
convention iLsed in PowerPlant. prepare_sources is also fairly 
naive about complex development environments. Depending on 
your own expertise with Makefiles, you may decide to build the 
development environment yourself. You do need to run the 
conversion scTipt, mac2unix, over the code to take care of the 
pascal strings and four character con.stanLs, however. 

Inside the PowerPlant code itself, there are a few 
motlifications we need to make. 

Template Instaniiaiion 

Template instantiation is not standardized across C++ 
platforms. When we brought PowerPlant away from the 
Metrowerks environment, we entered a world where multiple 
instantiations of C++ templates needed to be handled differendy. 

Tliere are two classic approaches to solving the instantiation 
issue: the Cfronl and Borland mtxJcLs. In Cfront all iastantiations 
occur in a single well-known directory. The Borland model, on 
the other hand, instantiates each template in each translation unit 
with duplicates ix:mg removed by the linker. Both techniques 
have serious flaws and have led to other approaciies. The gcc 
compiler that weTe using on Rhapsody, in particular, eschews 
these and pa>vides instead 3 different techniques. I’he details of 
dte problems encountered with all of these approaches will be 
deferred for a future article. In short, the only approach that 
worked was to: 

• disable implicit instantiadon (compiler opdon) 

• disable explicit instantiations in header files 

• explicitly instantiate each template in each translation unit in 
which the linker cx)mplained 

This soludon is not optimal because the burden for template 
instandalion is placed on the programmer. Change the code or how 
the translation units are combined and you may have to change 
where the explicit instantiations are placed. Bui it does work. We 
hope that better automatic approaches are found in the future that 
eliminates die ncxxl for any explicit insrantiaiion statements. 

For example, we liad lo turn off any explicit iasianlkdon 
statements that occurred in .h files {really a bad idea to begin widi): 

Fane_Classes/LView.h 

Hf !d&fined(HW _GCC_EXPT.TCTT_TRHPLATE_INSTAtJTIAT10N) 

template class TArray<I.Pano*>j 

#end 1 f 

and then to make sure diat source files dial reciuired the 
instantiations had them: 

Pa ne Cl a s ses / 1.V f ev * c p p 

#if defined (HW_C€C_.EXPL1C1T_TE«PUTE_INSTAHTIATI0N) 
template class TArray<LPane*>: 
template class TArrayIterator<LPaiie*>: 
feodlf 
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SCRIFTINC & AEObJECT SliPPt)RT 

Latitiicle's Apple evcnl implementation is not complete. 
While basic Apple event calls ar^ in place, AEObject support is 
not. PowerPlant uses AEObjects to record u.ser actions as well as 
trigger window management, such as taking a window down or 
allowing a window to Ixr dragged, PowerPlant's AEObjea code 
Is centmlized and it was clear where an event was dispatched 
and where it was picked up. Wc mtxlificd the code to perform 
the end result directly, will tout going through the AEObject 
dispatching mechanism. 

For example, PowerPlant’s LWindow::AttemptClose() 
function now looks like this: 

void 

LWindov; rAttemptCloseO 
I 

// G<a appFuvid fn^m SupeiComniaiidcr 
if ((mSiiperCoaanander “ nil) 

II nS u pc r Comma rtd e r - >A11 owS ubKemova 111 hia)) \ 

// Send Close AE for rccondiog only 
ffifdcf My_LATmJDl£_A3£„0BJECT_SUPP0RT 
DoCloseO : 
leisc 

SendS«»lfAE(kAECoreSuitc, kAEClose, false); 
delete thiat 
#endif 
} 

I 


LonoWorj:) AuGNMEisrr 

Mac resource data is kept in 680x0 alignment space, 
meaning long words can fall on short word boundaries. Reading 
in a 680x0 aligned resource on a platform in which lung words 
are aligned on long word lK>undaries yields inaccessible data and 
even segmeniaLion and bus errors, depending upon how the 
souRV code accesses tlie ckita. While some compilers have align 
pragmas that c'an keep stniaures in a specified alignment spacx*, 
these pragmas arc not common to all platforms, even with the 
same compiler We recommend that these pragmas nt)i Ixr used 
since they don't ensure portability. 

Latitude includes tfxjls to pack and unpack Mac resouix'es 
and file data, by u.sing these tools, your app is assured lo be 
ix>rtable to other platforms where CcKleWarrior Latitude is 
supported. Adtlilionally, Utitude's lg_align’ tcx)ls will perform 
byte swapping once Latitude is made available for x86 platforms. 

In PowerPlant, the LWindow::MakeMacWindow() funcliim 
sneaks a peek at a WIND resourc^e before calling Mac Window 
Manager’s GeiNewWindowO. The code fragment lor^ks like this: 

f:WTNDRRi5f>urf.RH theWind = (SWimRsourceH) 

: :CctR€3ourCR(QllADC0rfST('W‘/I*. ‘K \ inWINDid): 

Intib kind; 

tflfdef .LATITUDE. 

if (Ig align anpack{CHandie)theWlMU, SlflNDaesourcR_align) !“ 
noRrr) 

I 

r unpack failed! 7 

1 

#endif 

kind “ (••theWIHD),refcnn: 


'ITie SWlNDResotirce_aIign argument to lg_align_unpack is a 
LCt_ALTGN token array containing a description of the elements 
of llie WIND resource. Had we not done the ig_align_unpack, tlic 
kind variable would contain garbage since the lefcon field of a 
WIND resource is not naLurally long word aligned. 

Floating Winix>w,s 

Many Mac applications have floating windows and it seems 
that every Mac appfiattion accomplishes this feat differendy. 
Some patch traps such as FrontWindow, SendBehind, and 
WaitNextEvent, Some mcxlify the Window Manager’s WindowLisi. 
btiitude is capable of supporting noaling windows through many 
different mctliods. The best method, however, is to let Ladiudc 
float the windows without intervention. 

Regardless of how your applic^ation noats windows, it is best 
to alert Latitude diat a certain window is meant to float when the 
window is created. Ihis way latitude c:an make this 
communication to the gni layer and ensure dial the window is 
created with a flrraling allribule. 

In PowerPianfs UDesktop: :NewDeskWrndow{) function, we 
want to inform Latitude that the window we're about to create is 
a doater. Just before the GetNewWindowO call at the bottom of 
this Function, wc insert the following: 

ffifdfif UTITUDE. 

If (tnWlndow>Ha^Attrlbute(windAttr^EloRting)) \ 

LG_WMGR.WTt^D0W BLOCK wbloek: 

wblock,flags = LC„WMGR.WlNnOW_FLOAT; 

vblock,floats = LC.WIND0W^1S_FL0ATER; 

Ig latitude.next.wlndowt^wbloek); 

I 

#0 rut if 

if (tTEnvironsienL: :HasFeaturo(Rnv_SupportfiColor)) t 

iDaeWindowP = ; :CetNowCWindowClrvWTMnid, nit, inB^Mnd): 

1 else { 

niacUindovF “ ; ;GetHewti/indow(inWXHDid. nili inBehind); 

I 

CW Latitude has three settings for die floats attribute: 
LG_WtNDOWJS_Fl,OATER means dial thLs window is to float 
alTOve odier windows that aren't specified to float, 
LG_WlNDOW_HAS_FLOATERS is the default for regular 
windows. 'Ihese windows alltw (fillers to float above thenL 
Finally, LG_WTNDOW_MAS_NO^FLOATEILS specFies windows 
that must Qoat above all else. 

Coni kols As Drawings 

On the Mac, standard controLs are drawn in Quickdraw so 
the area they’re rendered in, when scrolled, behaves as cxi>ecied 
and the control scrolls with the area. This not the case with CW 
I^iitutle and the gui layers it supports. On systems like Motif, 
controls float above the window's canvas, so if drawings are 
scrolled across the window, tlie conlrf>ls will not move by 
themselves. They must \xi explicitly moved. 
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PowerPlanfs LPane::AdaptToSuperScroll{) adjusts ilic 
coiitroPs rectangles l>ut doesn't move the controls themselves, liy 
overriding AdapfloSuperScroil tor the LStdControl class and 
adding a Draw(nii) call, we can be sure that CW Latitude's gui 
layer will move the control for us. 

MllSCIJr 

With as mudi PowcrPlant as needed for Muscle ported, we 
can now begin looking at Muscle's source code. Since Muscle is 
almost entirely written in terms of PowerPlant, we have very little 
work to do. 

In the ColorTutor example, we had to remove instances of 
qd. for CW Latitude. In C++ applications however, the 
QDGIobals type is a class of inline definitions tied to the 
Quickdraw low memory globals and the apt)lication must define 
ifs own QDGIobals qcl. So at the top of CMuscleApp.c, we add 

#ifdef ,UTITUDE„ 

CJDClobais qd; 

^endif 

We also add a lg_latiLudeJnitO call similar to the one we 
added in ColorTutorc. Muscle's signature is 'MePo', We can alst> 
turn on CW Latitude's gui colorization so that windows have a 
default background color that matches the rest of their desktop. 

voidmaiaC long arge, char ‘*argv } 

I 

#lfdcf .LATITUDE. 

LG.AFF.mFO.BLOCK Iblock: 

Iblock.flags = LG_APP^IHFO_SIGNATURE \ 

LG.APP.INFO.CUSENAME | 

LG APP INFO WINDOW GUI COLOR; 

Iblock.signature = QUADCONST( .'e \'P’*'o' ); 

Iblock.clflssname ’ ”lratitude" ; 

Iblock.window.gui.color = 1; 

lg_latitude.init t arge^ argv. Selbiock 3; 

#endif 

Muscle contains a demonstration of PowerFlanLs QuickTime 
suppon. Unfortunately, Rhapsody does not yet suppon 
QuickTime. Latitude will rely on Rhapsody's own QuickTime 
support once it becomes available. At this point, it is necessary 
for us to #ifdef out code involving Quicklime. I'his code ts 
centralized in Muscle’s CMuscleApp.cp file and is easy to spot. 
QuickTime initialization and destruction code in 
CMuscleApp::CMusleApp and CMuscleApp::-CMusleApp, 
QuickTime demo .selection code in CMiisleApp::ObeyCommand, 
and CMusleApp::FindCommandStalus can all l>c #ifdcfcd ouL 

Porting YOUR Appijcation 

As any seasoned Mac programmer will agree, there is a lot 
of lore in Mac programming. Having assisted many Mac porting 
projects using CodeWarrior Latitude since its beginnings, we 
have seen some porting efforts go smtK)thly and some go rough. 
Knowledge of Mac programming lore is key. 

The make-up of the porting team makes all the difference in 
the world Tlic liest team combines experience from lx)th Mac: 


StoneTable 

You thought it was just a replacement 
for the List Manager ? 

We lied, it is much more ! 

Tired of always adding just one more feature to your LDEF or 
table code ? What do you need in your table ? 

Pictures and Icons and Checkboxes ? 
adjustable columns or rows ? 

Titles for columns or rows ? 

In-line editing of cell text ? 

More than 32K of data ? 

Color and styles ? 

Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your time ? 

See just how long the list is for StoneTable, 

Make StoneTable part of your toolbox today ! 

Only $200.00 MasterCard & Visa accepted. 

StoneTablet Publishing 
More Info & demo Voice/FAX (503) 287-3424 

http://www.1eleport.com/-'Stack stack@tGleport.com 


and Rhapsody environments in addition to a strong under¬ 
standing of the underlying Mac code ha,se. 

Less advantaged teams are made up entirely of either Mac 
programmers who aren’t familiar with Rliapsody details or 
Rhapsody programmers who have no Mat: programming 
exfjerience and are not at all familiar with tlie code base lieiiig 
ported. Experience from botli sides is necessary. Rliapsody 
and/or UNIX skills are needed to properly set up the 
development environment and address plaifonn issues. Mae 
skills are needed to understand what exactly is being done in the 
application source code. By uiking the time to put the right team 
together for the job, your porting project will be mu<::h smcKither 
and easier. 

We’ve touched on only a few aspects of the process of 
porting Mat: applications to Rhapsody. Fortunately, Power? I ant 
and Muscle do not contain many of the irmginaliw coding 
techniques weVe seen in other Mac applications. Many of these 
issues are discussed in the CodeWarrior l.atitude Guide that 
accompanies the CodeWarrior Latitude software package. 

We invite you to stop by Developer Central at MacWorld in 
San Francisco, January 6 - 9* 199B, and see Utitude in action. 
Yoti can pick up the ColorTuu>r and other .sample ctxle at 
MacTech's web site. And don't forget to stop by 
www.metrowerksxonn for up to the minute updates on CW 
liiliuide and Metrowerks’ other products. K1 


Januahy 1998 • iVtAcnVcii 


CodeWarrior Laittude: PoR'nNG Your Aprs to Rhapsody 


53 







PROGRAMMER'S 

CHALLENGE 


by Boh Boonstra, Weslford, MA 



Cfxi. Sn-Ecmotv 

One year ago, ihe Macintosh world was full of rumors about 
the piospect of Apj^le acquiring the Be Operating System. 
MacTech bundled the DR8 BeOS CD-ROM with tlic magazine. 
The Challenge column invited readers to try tlie BeOS on their 
Macs and enter the first BeOS Challenge. I'hen, before the BeOS 
issue had even arrived, Apple announced its intention to buy 
NeXT, and the journey u> Rhapsody began. 

Even though BeOS has faded from the headlines, it runs 
l^etter on your Mac than it ever did. In fact, Preview Release 2 is 
scheduled to arrive in the immediate future. My personal interest 
in BeOS has lx:en reinvig(>rated by a rexeni l^ai^ain that was too 
good to pass up - a dual 200Mli2 604e MaxFOWR 400 prtKessor 
upgrade. While it is possible for developeni to lake advantage of 
multiple processors under MacOS, using a special nonsymmetric 
interface develotxfd in conjunction with DayStar, multiproceSsSing 
MacOS applications are the exception rather than the nile. Not 
so, of course, with BeOS, where symmetric mulliproccs,Hing is an 
intrinsic part of the oiKTating system. 

In honor of the one-year anniversaiy of the Muclech BeOS 
issue, and in celebration of my new 2x200 MJiz toy, the C'hallenge 
this month is going to encourage tlie use of multiple [)nx:essors. 
Yt;u will lx: al)Ie to use* eithcT BeOS or MacOS. If you choose to 
use MacOS and wish to uike advantage of the second prexessor on 
my test system, you should use the SDK found at: 
<^tp://dev.apple.com/devworid/De\«lopment_Kits/Multiproc5sing_SDK.sit.hq^ 

Tlie jjrobiem tills month, suggested by Jon ''h++" Watte, Is 
to implement a CellSeiection class. CellSelectifin implements a 
twoxiimensional set of cells, each of which can lx '"on" tjr "ofr, 
along with a collection of methods to manipulate cell stales. 


The prototype for the code you should write is: 

dest., os “ be oe 

#tncluEi«i <SupportDefs.h> 

typedof long int32: 

typedef unsigned long uint32: 

#endif 

struct Area I 

iiit32 left, top, right, bottom: 

r todfiiitniitrs ait kidusivc. (2.2,5.41 induilc5 6 ctlfe, V 
/■ Any area with ldt>ri^t or fop>bottoin bi empty. */ 

1 : 

class CellSeiection ( 
private: 

/* add your uwrthixls and insiamx* variablci ht a' 7 
public: 

CelISelectIon(void): 

/* create an empty scicction V 
“CellSeiection[void); 

/* free any alioeaicd memory V 
bool Clear(): 

/' make ihc selection empty 7 
bool Add[Area area); 

/* add the area of cells to this selection 7 
bool Remove (Area area) : 

/* remove i(ic area of cells from this sclcciion 7 
bool Invert(Area area): 

/* remove cclb in lire area that are al^ in this .'idecliun 
and add the area eeib that arc not in this seleetion 7 
bool AdcKconst CenSelection ji OthetSelection): 

/* add the olherSeJeciion to this seleaion 7 
bool Remove (const CellSeiection ft olherSelection); 

r remove the oiherSekaJoii fronr thb sclcetiim V 
b<K)l Invert(const CellSeiection i otherSelectionJ: 

/* remove edls in the othcrSclcLikm Utat are also in this selcctioo 
and add the otherSclcetitm cells that are not in tliis selection 7 
bool A11Selected(Area a rea): 

/* return TRUE if all cdls in the area arc selected 7 
uint3a CountSelected (Area area); 

/* count cells t hat arc 'on* 7 

bool EqualSelected(const CellSeiection h otherSclcctlon): 
/* return TRUE if mherSelccdon equals this selcL tion 7 

1: 


THE RULES 


Here's liow it works: each month we present a new programming 
dmiJenge. First, write some code that solves the challenge. Second, oprimi/e 
your axle (a lot). Then, submit your solution to MacTech Magazine. Wc 
chotjse a winner based on code correctness, speed, size, and elegance (in 
that order of importance) a.s well as the submission date. In Uie event of 
multiple equally desirable so!uiions, well choose one winner (with 
honorable mention, but no prize, given to the run nor up). The prize for each 
month's best solution is a $100 credit for Developer Depot™. 

Unless Slated odietwise in llte problem statement, tlie following rules apply: 
All solutions musi he in ANSI aimpatible C or C-h^, or in Pa^l. We disqualify 
entries with any assembly in them (excejx for diallenges spedficaily stating 
otherwise.) You may call any Macintosh Toolbox routine (e.g., It doe:^! matter if 
you use NewPtr instead isf malloc). ’Wfc compile all entries into native PowerPC 
etxle widi txKupiler options .set to enable all available speed optimizatton-s. The 
deveUypmeni environrnenl to l)e used for selecting the winner will l?e stared in the 
problem. Limit your axle to 60 characters per line or comfxess aixl Nnl>ex the 


stiuUon; litis Iteljxs witli e-mttil gateways attd page laytxit. 

We publish the soluthm and wimieru for each month's Programmer's 
Challenge three months later. All submissions must l>e received by the Ut day 
of the month primed on the from cover of this Issue. 

You can get a bead start on the Challenge by reading Ihe Programmer s 
Cliallenge mailing list. It will be posted to the list on or before the 12rh of the 
preceding month. To join, send an email to li.stserv^li.stmail.xplain.cora with 
the subject “subscribe diallenge-A". 

Mark solutions ‘Attn: Programmers Coitallenge Solulitm* and send it by 
e-mail to one of the Programmer’s Challenge addresses in the '’How to 
ConuKunicate With Us" section on page 2 of this issue. Include the solution, 
all retaled files, and your contact Uifo. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer's (;hallenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation uptm sutmiL'wkm of each entry. 
Authors retain copyrights for the code. 
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The destmetor should free any memory all(jcaied by Llie 
eonstructor or t>y any of die nietliods of Cel I Selection. The Add 
method should turn on any cells in the ares or otherSe I action; 
similarly the Remove method should turn off the specified cells. 
Invert Is an exclusive-or operator that turns off cells dial are tm 
and turns on cells that are off, provided the cell is in the specified 
area or otherSelection. The Clear method re5et5the .selecficrn to its 
original empty state. All of these methods return TRUE if diey 
succeed or FALSE if they lun out of memory. The AllSelected 
method determines whether all of the cells in the specified area 
are on, while the CountSeIccted method counts the number of 
cells in tlie specified area tliat are on. Finally, the EqualSelected 
method determines whether the selected cells in this CellSetection 
are the same as the selected cells in the otherSelection. 

The test code will require you to create a modest number of 
CellSelection instances (perhaps 10 to 50) and manipulate them 
with a larger number of Add/Remove/Invert cj^perations, 
interspersed with a modest number of 
AIISelected/CountSelected/EqualSelected tests. 

Ihis will be a native PowerPC Challenge, using the latest 
CodeWarrior environment. Solutions must be coded in C++, 
written for cither the Macintosh oix^rating system or the Be 
operating system. You can use all of the available memory in my 
96MR 8500, but your eexie must fail gracefully if it runs out of 
memtJry. Your solution should include a complete CodeWarrior 
project file and test driver, compressed into a .sit or .ept archive 
(for MacOS) or into a .zip, .g?. archive (for BeOS), fll evaluate 
your solution using the target operating system you designate, 
and the fastest correct solution will be the winner. Memory- 
inefficient solutions that fail to handle large problems will be 
considered les,s tiorrect than memory-efficient solutions. 

I'rree Months Am Winner 

Congratulations to Randy Boring for submitring the 
winning entry to llic Wlio Owns die Zebra Challenge. Recall diat 
this Challenge required you to parse a set of inputs representing 
clues like American lives in the house with the red door'' 
and 'The person who drinks orange juice owns the dog" and 
solve a problem like “Who owns the zebra?" Randy’s solution 
was faster than the second place solution in three of four test 
cases, and some 25% faster in the largest test t.'ase. 

Randy's soludon maintaias a mask matrix, gLocationsQ, to 
indicate whicli locations are still possible for a (solution row, 
location) combination. He also maintains a value matrix gValuefj to 
indicate wliich Itxation assignments remain [wssiblc for a given 
(variable, value) pair. Clues tliat constrain location assignments 
manipulate these data srmcaires directly, while clues that relate 
(variabic, value) pairs propagate die locatitm constraints of each 
pair to the other pair in tlie routine ApplySAME_ ROW. Constraint 
propagation is done in the ApplyXXX routines, which should be 
examined to understand how this .solution works. If a solution is 
not evident when all of the clues have been applied, the 
ThinkRealHard routine hypothesizes a new constraint and 
propagates tills artificial clue, terminating when a solution is 
reached or when it runs out of constraint hypodieses. 


I would ixr remiss if I did not mention the Java solution 
submitted by David Whitney, in a self-profes-sed ''blatant 
violation" of the titles. Although his solution suffered in 
execution time, I found it inieresling. PcTliap)s it is time for a Java 
Challenge... Any ideas? 

The table below lists the execution times, code size, data 
size, and programming language for each entry. Execution 
time is listed in milliseconds for each of four problem 
dimen.sion values tested; 3, 5, 15> and 31- Solutions which did 
not solve a test case in a reasonable amount of time (several 
minutes) arc listed with an asterisk and did not win any 
Challenge points. The number in parentheses after the 
entrant's name is the total number of Challenge points earned 
in all Challenges to date prior to this t>nc. 


Name 

Total 

Time 

Time 

Time 

Time 

Qitic 

Data lang. 


Time 5 

5 

15 

31 




R3iid>' Boring {41) 

728,6 

0,3 

0.6 

3L3 

696.4 

3400 

22530 C 

Ernst Muter 

972.8 

IS 

2.2 

29.7 

9.39.4 

6420 

128 C++ 

\y,iv\d Whtlney^ 

477247.0 

1340 

410.04767030 

« 

4WK) 

0 Java! 

Wilteke Ricken (10) 

* 

0.4 

1.6 


m. 

6920 

543 C++ 

Ken Skziik (20) 

* 

0.4 

« 

* 

A 

6340 

232 C 


Top 20 Contestants 

Here are the 'lop Contestants for the Programmer's 
Challenge. The numbers lx:low include points awarded over 
the 21 most recent contests, including points earned by this 
month’s entrants. 


Hank Name 

Points 

Rank Name 

Points 

l.Muntei; Ernst 

210 

11,Day, Mark 

20 

2. Boring, liandy 

61 

l2.Higgins, Charles 

20 

3*Cooper, Greg 

61 

13.!.ars.son, Gustav 

20 

4. Lewis, Peter 

57 

14,Lengyel, Eric 

20 

5.Nicolle, Ludovic 

48 

15.Saltier, 'I'homas 

20 

6. Murphy, ACC 

34 

l6,Saxt.on, Tom 

17 

7.Creggj Xan 

33 

ly.Gundrum, Eric 

15 

8.Maiiett, Jeff 

30 

IB.Hart, Alan 

14 

9.Amoniewicz, Andy 

24 

19.0’Connof, Ttirlongh 14 

lO.Picat), Miguel Cruz 

21 

2().Karsli, Bill 

12 


'there are three ways to earn points: (1) scoring in the top 5 
of any Challenge, (2) tx:ing the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Cliallenge that I use. 'Ihe points you can win are: 

1st place....20 points 5th place...2 points 

2nd place.10 points finding bug...2 points 

3rd place.7 points suggesting Challenge...2 points 

4th place.,.4 points 
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I lere is Randy's winning solution: 

Zebrax 

© 1997, Riindy Boring 

jllnf:lude "Zebia.b" 

tfincludG <sLrlrig.h> 
finclude 

jFinclude <£tdlib.h> //for eiuUoc aod 

typedef enum { 
kClueNextTo, 
k C1 ue T mmed RightO f * 
kCIueTramedt-cftOf. 
kClueSamoRowAGj 
kClueLocatedAr 
1 ZCLueType; 

typedef &num \ 

kContradlctlon - -1* 
kSoIved 0. 
kUnsolved * 1 
\ ZSolutionStatc; 

// global siripg coti^iaLs 
// iclatiom 

static const CStr25S gsrISA - “ISA": //vamWc mcnibcrslup 
static const CStr2SS gSrIS LOCATED = "IS LOCATED": //alisolmcpiwatkxi 
// tcktivc position relatkms 

static const CSir255 gsrNEXT_TO “ "NEX7_T0"; 

static const CStr25& gsrlWKED_RIGIIT_OF - "IMMEU^RIGHT.OF": 

static const CStt255 g 5 rlHMED_^lJiFT_ 0 F - “IHMED^LmLOF": 

// absolute poddon values 

static const CStr255 rsvIN MIDDLE - “IN.MIDDLE": 
static const CStr25^ gsvAT RIGHT - “AT RIGHT": 
static const CStr255 gsvAT_LEFT = “AT LEFT"; 

// parts of the Question 

static const CStr2&5 gaqSOLVE "SOLVE": 
static const CStr255 gsqANSWER - “ANSWER"; 
static const long kMaxValuas - 964: 
static const long kMaxVariables 31: 

// bit anmy of possible locations 

// has just a single bii set when tocatkm b known 

typedef unsigned long ^Location: 

static const ZLocation kLeftBlt = OxBOOOOOOO; 
static ZLocation gHask: 

typedef struct value I 

1 ong loc: // index of possible locaikins for this value 

struct value *next; //next ^Iik’ of this Jliypc 

void • type: // points to the vatiabk^ (ZJype) tliat wc ate a postdbk: valit of 

char * name: // name given for this ZVaiue 

J ZValueRec* *ZVaiue: 

// a Ziypc is the definit ion of a variable, induding its natiu: and possible valixrs 
typedef struct type I 

ZVaiue va 1 ues; // list of possible values for this variable 

St rue t type * next; // next variable of iliis problem 

char * name: // name given for this variable 

long order: // print order of llib variable in soiui ion 

I ZTypeRec, *ZType: 

// a ZQue is a Faei that must be used tri s(»lve the puzzle 
typedef struct clue I 

struct clue “next: //next due in list 

ZC1 ueType typer // which kind of clue 

ZVaiue f irstValue: // first variaWe of dus clue 

ZVaiue second Value: // second variable of diis due 

] ZClueRec, •ZClue; 

typedef struct q I 

ZCl ue head: // front of line where things are taken off 

ZGlue tail; // back of line where things atWed 

1 ZQHec. *Zq: 

static unsigned long gDim: 
static unsigned long gNimClues: 
static unsigned long gkBlDckSlze; 
static unsigned long gkBlockSiKeTnLongs; 
static ZQRec gQHecUnsatlsfled; 
static ZQRec gQRecSatisfled; 


static ZQ gQIln = &gQRecUnsatisfled; 

static ZQ gQSat = &gQRecSatisfied: 

static ZTypeRec gVarsrkHaxVariables]: //32(31 bmax) 

static ZValiicRec gValuea [kMaxValues] : //(9^) 31 X 51 (96l) is max 

static ZLocation gLocallons(kMaxVa1ues] :/K^i4)31 X 31 <%1) bmax 

static ZLocation *gL - gLocations: 


^define FirstVarf) 
define FlrstValueOf{var) 
^define NaraeOf(x) 

#dorine SetHaraeOf(x» s) 
jdefiue NextOf{x) 
ifde fine S e t Next U f (x, y) 
^define LocationOf[v) 

^define SetLocationOf(v» L) 
jdefine TypeOf(c) 

^define SetTypeOf(c, t) 
jdeflne PrintOrderOf(var) 
jfdeflne SctPrinLOrcicr(var,n) 
l^defitie FirstValOf (e) 

^define SatFirstValOf(c, v) 
^define SecondValOf(c) 
jdefine SetSecondValOf(c* v) 


Ct(gVars[on) 

(Cvar)->values) 

((x) ->nanie) 

((x) ->narae = (s)) 

(lx) >nextj 
t(x) >neKt ' (y)) 
tgL[ (v) Olocj) 
[^l(v)->iocJ = (D) 
({c)->type) 

((c)*>type - Ct}) 

((var)*2order) 

(Ivar) border = (n)) 

((c) >flrstValuc) 

((c)'>flrstValue * (v)) 

C(c)-^secondValue) 

((c)->secondVaiue = (v)) 


[nitQ 

// initialise queue q 
static void 
InltQ(ZQ q) 

[ 

q->head “ nil: 
q >tail - nil; 


^define QNotEmptyCqJ (Cq)->heed != nil) 
^define QIsEmptytq) C(q)‘)head ^ nil) 

// Add c to end of queue q 
static void 
EnQ(ZQ q* ZClue c) 

I 

if (q'>head ^ nil) 
q->head = c: 
else 

SetNexlOf(q->1311. c): 
q >tall = c; 

SetNextOftc, nil): 


// Remove the due at the front of queue q and Return *1 
static ZClue 
DcQ(ZQ q) 

I 

ZClue c = q->bead; 
q->head = NextOffc); 

SetNextOf(c* nil): 
if (q->head nil) 
q->tail “ nil: 
return c; 


// Add the dements of the first queue to the end of the 
// second queue (removing tln-iti from ihc first one) 
static void 

MergeQ(ZQ from, ZQ to) 

\ 

while (QNotEmpty(from)) 

EnQ(io, DeQffrotn)): 

I 

static void 

Moved(ZQ from, ZQ to) 

I 

to->he3d * frQin->head : 
to >lall froin->tail: 

I 

Static void 
MakeMask(iong dim) 

I 

ZLocation currBit “ kLeftBit: 
gHask ” 0; 
while (dim ) 

[ 
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gMask - gHask | currBit: 
currBlt »-= 1; 

) 


I 


// Mjikc the variablt: field for Uic problem 
// dtm nmn, eacli with dim ty’pe*« 
static void 
AddLoca tio na flong din) 

I 

long vari, vali 0, loci ^ 0; 

for (vari “ 0; varl < diin; vari++l 

[ 

long addValuesStop * vali + dinir 
gVaTs [vari] .values " ^(gValijt^alval i]); 
gVars [varll.next ■ fc(gVara[varJ + 1]): 
gVars [varl].name “ nil; 
do 1 

gL[loci] " gKask; 

gVaiues[valij ,ioG = loci++; 

gValues[vali].next “ &{gValues[vali f 1]): 

gVaiues[valil,type “ &{gVara[vari]); 

gValuesfvalil ,naJne - nil; 

valif+; 

I while (vail < addValuesStop); 
gValues [vali 1] .next - nil; //lemdiiatc die Usl 
I 

gVars[vari - Ij .next - nil: //icmunatcthe list 
I 


IniiStroaufe 

static void 

TnitStructure(long numClues, long problemDimensionJ 

I 

gkalockSizeinLongs ■* probiemDinension * problemDimension; 
gDira “ probiemOimension; 
gNuiaClues * nmaClues: 

gkBlockSize - gkElockSizeTnLongs * sis-.eof (^Location}; 
MakeHasktprobleiiDimenu ion); 

AddLocatlons EgH tm); 

TnHi;i(gQUn): 

InltQ(gQSaL); 


static void 

Re1ea s eMemo r y C vo1d1 

I 

while (QNoiRnipiy(gQUn)) 
frecCDeQ(geiUn )); 
while {QHotEiBpty (gQSat 1) 
free(Dea(gQSat)): 

) 

static void 

CopyLocstions(ZLocation •from. ^Location 'to) 

( 

BloekMoveDataUPtrJ from* (Ptr) to, gkfllockSize); 

1 


// Starting ai r word beginning, sordi for its end. 

// NuU-termln^nc the wiird, nulkiut any extra space, and 
ff retnm the location of the next w<irtl. 
static char * 

MakoWord8rcflk(chat 'w) 

( 

while (*w 1= ‘ *w) 

w++: 

while (*w * *) 

*wt+ - 0: 

return w; 

J 

Static ZTypo 

FludOrCreateType(char *aVariable) 

( 

ZType t * FirstVarO; 

while (t nil && NaraeOfCt) 1“ nil 

&& (0 !" stremptNameOf(t), aVariable)1) 
t - MextDfEL); 
if (t r- nil) 

SclNnizcOfCt. a Variable); 
return t: 

1 



Cross Platform 

Mac, Windows, OS/2, Unix 

Database 


Object-oriented, C++ syntax 
Faircom c-tree Plus® 
dBase 111+ and IV 


Report-writer 

Mac & Windows WYSIWYG 
RTF & HTML 


Graphing 

Standalone or within reports 

Frameworks 

PowerPlant & MFC 

Code-generation 

AppMaker and OOFILE create 
complete database applications 

dent@highway 1 .corri-OU 

WWW. highway 1 .com.au/adsoftware/ 

Visit the AppMaker stand 
in Developer Central 
Macworld Expo SF 
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static void 

AddFossibleValueCZType var, char ^aValuc] 
i 

ZValae v » FirstValueOf(var)j 
while fv 1= nil && ilameOf(v) !“ nil 

&& (0 (“ st rcap((laiieOf (v), aValue))) 

V - NextOf(v)T 
if (v 1^ nil) 

SetNaraeOftv^ aValue); 
else 

DebugStr(“Npv is nil I"); 

J 

static ZLocatlon 
FindLocationichar *aLocation) 
f 

ZLocation loc ^ 0^ 

if (Btrcmp(aLocation, gsvAT_LEFT) — 0) 
loc * kLaftBit: 

else if Cattcmp(aLocation, gsvAT_RlGHT) = 0) 
loc * kI*efr.Bit » (gDin * 1) : 
else if Catrc(np(aI-oCBtion* gsvlM_HIDDLE) 0) 
loc - kLeftBlt >> CgDliii » 1 ); 
else 

DebugStrCVp Not a valid location!") ; 
return loc: 


static ZTypc 

FindTypeNaaied(char *aVarlahle) 

I 

ZType t “ firstVarO: 

while Ct !“ nil (0 !“ strcmp tMameOf (t), aVarlable})} 
t = KextOf(t); 
return t; 


static ZType 
FiiidTypeOrdered(long n) 

[ 

ZType t ^ FirstVarO: 

while (t !•* nil hk PrlntOtderOf (t) J= n) 
t = NextOfCt): 
return t; 

I 


FindValueNamrd 

// Return the Zl^ue that is named aN^uc 
static ZValue 

FindValueKamed(char *aValue} 

I 

ZType var: 

ZValue V - nil: 

for (var * FirstVarO: var f“ nil: var “ NextOf{var)) 

I 

V “ FlrstValueOf(var): 

while (v 1“ nil A A tO != strcrapCNameOf (v), aValue))) 

V ” NextOflv); 
if (v 1= nil) 
return v: 

1 

return v; 

) 


IsSoJvedLoc 

// Returns true if the location, n, b ‘solved’, that b, 

// if ii has cjtaaty one bit set 
static ZSolutionState 
IsSolvedLocCZLocation n) 

I 

// no set hits Itumd yet 
^Location currBit “ KLeftBlt; 
long 1 ^ gDlm: 
if (0 “ n) 

I 

// Dcbl^^^*^p Oversoived bitH; 
return kContradiction: 

J 

while (1-) 

I 

if CcurrBit & n) 
break; 


currBit »= 1; 

I 

ctirtfiit »“ 1; 

// one set bit found 
^ile (1^) 

[ 

if (currBit k n) 

return kUnsolved : // two set bits ^nd! 

currBit »= 1: 
j 

return kSolved: // exactly one set btt was found 

1 

FindVdueWithUnsolvcdLocation 
// Return the first ZVkloc tliat b has an unsolved locatkm 
// Ihat is, the iocatioo b not just a single bit. 
static ZValue 

FindValueWithUnsolvedLocation(void) 

I 

ZType var: 

ZValue V = nil: 

for (var = FirstVarO: var till; var “ KextOf(var)) 

( 

V - FirstValueOf(var): 
while (v !“ nil (kSolved “ 

IsSolvedLoc fLotationOf(v)))) 

V = NextOf(v): 

If (v 1= nil) 
return v: 

1 

return v; 

1 

// MfTTE: watch out for the typecast in here 
static void 

AddFactLocationAbsoluto(ZLocation loc, ZValtie val) 

I 

ZClue c = iDalloc(sizeof (ZClueRoc)): 

SetType0f(c* kClueLocatedAt): 

SetFirstVal0f(c, val); 

SetSecondValOf(c, (ZValue) loc): //overload! 

EnQ(gQUn. c): 

1 

static void 

AddFactLocatlonRelativeHextTo(ZValue aVal, ZValue bVal) 

i 

ZClue c ” malloc(sixfiof(ZClueRec)); 

S etTyp eOf( c * kClucNe x t To); 

SetFirstValOf(c. aVal): 

Sets ec ondValOf(c, bVal): 

EnQ(gQUn. c): 


static void 

AddFactLocationRclativeOnRlght(ZValue aVal* ZValue bVal) 
( 

ZClue c ™ malloc(sixcof(ZClucRec)); 

SetTypeOf(c* kCiuelmmedRightOf): 

SetFirstValOf(c* aVal); 

SetSecondValOf(c, bVal): 

RnQ(gQlJn. c): 


static void 

AddFactLocationRelativeOnLeft(ZValue aVal* ZValue bVal) 

I 

ZClue c “ mallocCsizeof(ZCiueRec)} : 

SetTypeOf (c, kCluelnmiedLeftOf): 

SetFlrstVa]Of(c* aVal): 

SetSecondVal0f(e. bVal): 

EuQ(gQUti* c); 


static void 

AddFactSameRcw[ZValue aVal. ZValue bVal) 
I 

ZClue C ~ Qialloclsizeof (ZClueRec)): 
SetTypeOfCc* kClueSameRowAa); 

SetFirst ValOf(c, aVal): 

SetSecondValOfCc. bVal): 

EnQCgQUn, c]: 
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Static void 

AddFactlDiportantValueCZValtje vnl) 

I 

i^pragma unuspd (val) 

I 

.static void 

Add Fac timpo r t a ntTyp e(ZT/p e t ype) 

I 

^pragma unused (type) 

1 


PtckcssISA 

//Assficiatcs aVaJue with aVariablt. tiiat wtr kociw that 
// aValiic is a possible vaJue for the Sn^pe a Variable. 

//The nype aVariabIc is created if it tbicsn't already exist, 
static void 

ProcessISA(cliar *EVaTiic, chat 'aVariable) 

t 

ZType v: 

V ' FindOrCreateType(aVariable ); 

AddFotialbleValue(v, aValue): 

J 


FrcjccsalS LCK^ATED 

//AsMJCtatcs a Value with aLocaiion.so that we know Uiat 
// aValue at the bx:ation aLocaiion. 
fit.Ttlc void 

ProccsaIS_LOCATED(char “aVaiue, char *aLocation) 

I 

ZLocation Lot; 

ZVaiue valr 

loc ” FindLocation(aLocation): 
val ^ Ff ndValueNained (aValue): 

AddFactLocatiofiAbsolutedoc* val): 

1 


ProccssNliXTJD 

// Associates aValiJc with hV^ue, so that wc know that aValuc is located next to 
// hValiir. (This alsti implies that bValiic Is next to aWoc) 
static void 

PrdCesnKKXT_TO(char *aValue* char *bVaIue] 

I 


ZValue a* b; 

a - FlndValueKaiaed(aVaiue) j 
b = FindVaiuaNajned (bValue); 
AddFactLocationRalativeNextTola. b)t 


PnK:cs,sTMMHD^RTGHT_Of 

//AfiSfxaatcs a Value,' with bValutvso that wc know that aVaJue is located to the 
// immediate right of hValuc. (Also, bVaiuc is to the immediate left of aVihte) 
static void 

ProcessIMKED_RIGHT OF(char *aVaVuc. char *bValue) 

I 

ZValue a. b: 

a “ Find Val ueHaait?d(aValue); 
b ^ FindValueNained (bValue) j 
AddFactLocatioaReiativeOnRightEa, b); 


PtocesslMMHD.LEFT.OF 

//Assodates aValue with hVklue, so that wc know that a Value is located to the 
// immediate left of bl^hjc. (Also. bValtx: is to the ttmnediate right tjf aValiic) 
stntfe void 

ProcesslMHi:i>_LEFT_OFCcbar ’aValue, char •bValue) 

{ 

ZValue a, b; 

a "=* FindValueNamed (aValue): 
b - Find Val ijeNamcid(bValue)j 
Ad d Fa c t L oc atlouRe1ativeOnLe f t(a. b): 

1 

static void 

|}oublallullTar]itinate(cbar 'line) 

I 

long len * sttlanCline); 
lineflen + 1] =0: 

I 


ProcessSOLVE 

// Remembers that the remaining words arc imptJrtanh both values arid 
// variabks.Tlic solution fe done when every value mentioned here is known 
// for certain^ and every variable has a compatible <if not giiaraDiecd) value, 
static void 

ProcessSOLVEfehar 'currWord, char *nextWord) 

I 
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Pi:ocessRelatiaii{ f 1 rstWord. secondVord , nextVford): 


DoubleHullTeriniiiate tn^JctWord): 
while (‘ cxirrWord ] 

I 

EValue val “ FindValueNaiied(ciirrMord); 
if Cval) 

AddFactTiQportantValue(val ); 
elae 

I 

!LType type * Fi n d Ty p eH anted t cur rWg r d J: 
if (type) 

AddFactlttportantTypeCLypc); 

// el.^ k was a rriaiLon 

1 

currWord " nextWord; 

uextWutd “ MakeWordBreakCnextVord); 

1 


Pfix.xaisANiiWliR 

// Remembers the mtkriug of the rt maiiiiag words. 

//Ibis is the order that the helds tn tfie solution lines 
// arc filled with s'artable values. Czerobased) 
static void 

Proces3ANS¥EIl[char *eurrWord, char *neKtWord) 

I 

long 1 “ 0; 

ZType type: 

Doubl eNul ITersninate I nexiVoed): 
while (•currWord) 
i 

type “ FindTypeNaned (currWord); 
if (!type) 

DebugStr(*\pCan't find this type!"); 
else 

I 

SetFrintOrder(type, i): 
i++: 

1 

currWord = nextWord: 

nextWord “ MakeWordBreak{nexLWord); 

I 


ProccssReUkui 

static void 

ProceasRelation(char *firstWotd* char *relation* char 'thirdWord) 
I 

#pragB3a unused (relation) 

ZValue aVal; 

ZValuE bVal: 

aVal ^ FindValuoNawedCflrstWord); 
if (!aVal) 

return: // this is probably a meaningless 'vartabk: rrlaiion vaitibic' due* 

bVai “ FindValueNamedtthirdWord) I 
ir (IbVal) 

I 

DohugStr("\pNot a known value!"): 
return; // this is probably an errorT 

I 

AddFactSameRow(aVal* bVal): 


Pmecsi^AQue 

static void 

FrocesaACluc(CStr?.51 clue) 

I 

char 'firstWard = clue* *secondWordp •nextWord: 
secondWord ^ HakeWordlircak(firstWord): 
nextVo r d “ Ma keWo r dBr eak C s ec on d Wo rd); 
if (0 — strcffip(gsrlSA. secondWord)) 

ProcessTSAfficstWbrd* nextWord): 
else if (0 “ strcinp(gsrIS_LOCATED, secondWord)) 
ProcessiS^LOCATEDffirstWord. nextWord): 
else if (0 ^ sircinp(gsrNEXT TO* secondWord)) 

ProcessNEXT_TO(firstWord* nextWord); 
else If (0 "■ strciap(gsrlMME0_RTGHT_0F* secondWord)) 
ProcessI«MED^KIGHT_OFtfirstWord. nextWord): 
else if (0 ^ strciiip{gsrIMMED_L£Fr_OF* secondWord)) 

P roc es 9 1MMED LEFT^OF(fir s tWo rd * nexlWo r d): 
else if (0 — strcrapfgsqSOLVE* firstWord)) 

Process SOLVE(sec ond Wo rd, nextWo r d): 
else if (0 “= stiCKtp(gsqANSVER* firstWord)) 

Process ANSWER (secondWord, nextWo rd); 
else 


1 

void PropogateUniqueLocInColuimCZValue val): 


CkarOjLunui 

// Clear this bit In every value in this variable tixcepi 'skip' (the 
// wurce of clearing the others) Propogatc newly solved (ocations, 

// iuo- Don’t propogaic contradictions (zicmes) 
static void 

ClearColujDn(ZType colurui* ZLocutlon bit* ZValue skip) 

I 

const ZLocation clearHask “ “bit; 

ZValue v: 

for tv = FirstValueOf(coluim); v nil: v = NextOf(v)) 
if (v ^ skip) 
continue: 
else ( 

ZLocation orlginalLoc “ LocaiionOf(v): 

ZLocation newLoc “ originalLoc clearMask: 

If (newLoc !* originalLoc) 

[ 

ZSolutlonState at = IsSolvedLoc(nevLoc): 

SetLocationOftv* newLoc): 
if (newLoc && st kSolved) 

PropogateUniqueLocInColunn(v); 

//dse if (st = kOjntradictioa) 

//else if (St = Kl Insolvrd) 

1 

) 

I 


Pn ipugatcOniqucljoclnColumn 

// Erases this value’s location bit from every other value 
// of this variabic/column/type 
static void 

PropogateUnlqueLocInCo! iimn (ZValue val) 

'[ 

ZLocation loc = LocationOf(val); 

SetLocationOf(val. loc): 

Clea rCo1uran((ZType)TypeOf(val)* loc * val)i 

1 

typedef enum [ 

kRfisultCont radic tion * 
kResultProgress* 
kRe suits olvedFir s t. 

JiRgsuI t Sol ved Second * 
kRe su 11S 0 1ved Both * 
kResultNoProgreBS 
I ZApplyResult: 


CalciilatcAppiyResuli 

Static ZApplyRestilt 

CaIculateApplyResult(ZLocation resuUl. ZLocation resultZ, 
ZLocation originall, ZLocation originalZ) 

[ 

if (IresulLl || Jresult23 

return kKeaultConiradiction: 
if {result 1 1= original 1} 

if (IflSolvedLoc(resulll) “• kSolved) 
if (resultZ !“ original^) 

if (IsSolvedLoc(results) kSolvod) 
return kResultSolvedBoth: 
else 

return kResultSolvedFirst: //and progress on 2nd 

else 

return kResultSolvcdFirat; 
el Be // pinjgrosi on first 

if (tesultZ !“ original2) 

if (TsSolvedLoctresultZ) “ kSolved) 

return kResultSolvedSecond: // and pmgrcjss on Isi 
else 

rernm kResultProgress: 

else 

return kResultProgress: 
else if (resultZ != origltial2) 

if (TsSolvedLoc(result2) “ kSolvcd) 
return kResultSolvedSecond: 
else 

return kResultProgress: 

else 

return kResultNoProgress: 

I 
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ApptyNEXr.iX) 

s La tic MpplyResult 

ApplyKEXT_TO(ZValtia first, ZValiio second} 

( 

^Location otifilnalK orlginalZ; 

ZLocatlon result 1 * original 1 LocationOf(firsth 
ZlrOcatlon result! = original! * LocationOf (second h 
ZLocaiion tempi, temp2; 
do ( 

tempi result 1: 
temp2 - result!; 

// iiisi h to r^i or left of second 

result1 [(temp2 << 1} | [temp! » 1)); 

// second is to right or left of flrsi 

result! &= {(tempi << 1} | (tempi » U); 

1 while ((tempi E“ tesultl} || (terap2 t“ result!)); 
SetLocationOf(first, result]): 

SetLocationOf(second » resul t!): 
return CalculatcApplyRcsult(result1, result!, 
nr!gJnal1 * original!): 


Apply RJGini^Of 

static ZApplyResult 

ApplyRIGHT,OF{ZValue first. ZValue second) 

I 

ZLocation origlnail, original!: 

^Location rcsultl = origlnall - LoeationOf(first); 

ZLocation result! ” original! = LocationOf(second): 

ZLocation tempi, temp!; 
do I 

tempi ** result 1: 
temp! " result!; 

// first is to right of second 

tesultl 4“ (temp! » 1); 

// second is to teft of first 

result! &= (tempi « 1): 

I while ((tempi !“ resultl) || (temp! result!}); 
SetLocationOf(first, result1); 

SetLocatlonOf(second. result!): 
return CaIculateApplyResult(resultl. result!* 
origirmll* original!); 

I 


ApplyLEFT^OF 

static ZAppiyftesult 

ApplyLEPT_OF(ZValue firsi* ZValue second] 

( 

ZLocation origlnall* original!: 

ZLocation resultl “ originall ^ LocationOf(First]; 

ZLocation result! ^ original! = LocationOf(second); 

ZLocation tempi * temp!; 
do I 

tempi reaulti; 
temp! ^ result!; 

// first is to left of scoMid 

resultl fr (temp! « 1]: 

// second Is to riglii of first 

result! (tempi >> 1): 

I while ((tempi 1“ resultl} || (temp! != tesult!}); 
SetLocationOf (first * rcsuUl ]: 

SetLocationOf(second- result!): 
return CalculaieApplyResuIt(resultl. result!, 
origlnall* original!); 

) 


AppiySAME ROW 

static ZApplyResult 

ApplySAME ROWCZValue first. ZValue second) 

[ 

ZLocation originall “ LocationOf(first); 

ZLocation original! = LocationOf(second); 

// fim is in th<.‘ same row as iJie second 
ZLocation result ** (originall & original!]; 

SetLocationOf(first, result); 

SetLocationOf(second. result): 
return CalciilaicApplyResulr(result, result, 
originall, original!); 

1 


Tes HlTiHg 

Your Total Bug Tracking Solution ^ 


If you're o developer, you've got to get TestTrack, 

Your bugs will hate you for it!" Coot Tool of the Day 


Discover the tool leday's top softwore developers ore using to improve the 
quality of their Macintosh and Windows applications— TestTrack. 


* Track bugs, Feolure requesh, problem^ 
nislomer mformolion, and more. 

• New! E mud itoKflmlioiu—SMTF and MAPI. 

* NewF Import bugs m e-mail airtinmilkally. 

• Produce tondse rejKtfIs. 

* Multiple userSv full securily-link engineers, 
loslers, nunogers, even ledi writefS. 

■ Newl Improved help (Nc suppori. 

■ New! EkFened defect numbering, external 
ottochminf staroge, customer bug hislar'ies, 
and miKh, much, more. 

■ Aulixiraltcolly route bugs la team ntemb^^ 

« Track the htdory of each bug, 

• Save rime and improve lech supporl by 
gtwng Solo Bug, TeslTrack's sland^ne bug 
reporter to your customers. 


Only $169i 2+ lor $149 each! 
To order coll 888-683-64S6 
or 513-683-6456 




Downlood our demo today! 
http:// www.seapine.com 


Seapine 

Software 


ApplyLOClATED AT 

// Sci this v^ducs locatian tjn he toe 

// NCni; Gearing this bit in every other valiu: in iltb variaWe/column happens huer 
static ZApplyResult 

ApplyLOCATED.^AT(ZValue first, ZLocation loc) 

I 

// fir^I b located at loc 
SetLocationOf(first* loc]: 
return kResultSolvedFirst: 

I 


ApplyAQue 

static ZApplyResult 
ApplyAClue(ZClue clue] 
f 

ZValue first - FirstValOf(clue); 

ZValue second ” SecondValOf(clue). 

ZApplyResult rslt: 

switcMTypeOf (clue)) 

f 

case RCiueNextTo; rslt = 

ApplyNEXT_TO[first, second); 
break; 

case kClneTrainedRightOf; rslt “ 

ApplyRIGUT_OF(first, second): 
break; 

case kCluelraroedLeftOf: rslt “ 

AppiyLEFTjOF(first, second): 
break: 

case kClueSameRovAs; rslt 

ApplySARE_ROW(first, second): 
break; 

case kClueLocatedAt: rslt * 

ApplyLOCATED_AT(first, (ZLocation) second); 
break: 

I 

switch (rslt) 
t 

case kResullSolvedfioth: 
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PropogateyniquGLocInColusnn(first); 
d Bdl thioi^ for second, too 
case kResultSolvedSecondi 

?r opogat aUni queLoc 1 n Co 1 umrt C second ] t 
break; 

case kResultSolvedFlrst: 

PropogateUnlqueLocInColuiDii (first): 
break: 
default: 

c as e kEe s ultCont r adic tion: 
ease kleaultProgress: 
case kReeult^loFregress; 
break; 

I 

return rslt; 

I 


[^atlslted 

// Retum!i true If the clue )m been satisfied 

//ASSUMES it has just been applied (thus several check only one value) 
static ZSolutionState 
l3Satiafied(ZClue clue) 

1 

ZSolutionState satisfied; 
switch(TypeOf(clue)) 

I 

case kClueNeKtTo; satisfied = 

leSolvedLoctLocationOf(FirstValOf(clue))): 
if (satisfied “ kSolved) 
satisfied ” 

laSolvedLoc(bocationOf(SecondValOf(clue))) : 
break; 

case kCluelinniedRigbtOf: 

case kCluelamedLeftOf; 

case kClueSameRowAs; 

case KClueLocatedAt; satisfied ^ 

IsSolvedLoctLocationOf(FirstValOf(clue))); 
break; 

I 

return satisfied; 

1 


Check fjOcation!i 

// tihcck otic column, col, for newly unique k>caiions. Check only the locations 
// left in va). Check only the values bclow/after val, since the others wot ‘solved’ (had 
// unique solutioas already) Stop after finding the first one (and making it unique) 

// Return whetber any charq^s were made 
static Boolean 

CheckLocations(ZTypc col* ZValue val) 
t 

ZLocation currBit = kLeftBit; 

const ZLocation tryLocs - LocationOf(val); 

while (gKask & currBit) //for each location in purjtk 

I 

ZValue tryvi 

if (currBit h irylocs 0) //just locations in val 
1 

// check remaining values for this locadtm 

for (tryv * NextOf(val): tryv f= nil: tryv - NextOf (tryv)) 
if (loeationOf(tryv) & currBit) 

break; // found another value that could be in this location 

If (! tryV) //a unique lucaLionf 

1 

SetLocationOfCval* currBit); 

GlearColuinxi(col, currBit, val): 
return true; 
t 
I 

currBit »“ I; 

1 

return false: 

I 


(licckColumns 

// Check each column for newly unique locations 
// Return whetho- any changes were made 
static Boolean 
GbeckColimns(void) 

I 

ZType van 
ZValue V " nil: 

Boolean changes ” false; 

tor (vac ^ FiratVarO: var 1“ ail: var = NextOfCvar)) 

r 


V = FirstValucOf(var): 

while (v != nil (kSolved “ IsSolvedLocCLocuLionOf(v)))) 
V - NextOf (v); 
if (v nil) 

changes = changes || CheckLocatIons(var* v); 

) 

return changes; 


Apply EachUnsatisficdCliH: 

// Apply each due in the ‘ unsatisfied' queue. Return wliat progress was made, unless 
// a contradiction was made, then ictum feilsc to stop. Move satislied dues to qSat. 
static Boolean 

ApplyBachUnsatisfiedCIue(ZQ qSat) 

I 

Boolean progress = false; 

ZQRec stillUnsatisfied; 

InitQ(£istillUnsatlsfled): 
while (QHotEoipty [gQUn)) 

I 

ZClue clue = DeQ(gQUn): 

ZApplyResult rslt " ApplyAClue(clue): 
if (rslt = kResultContradiction) 

f 

£nQ(qSat, clue); 

HergeQC&stillUnsatlsfied, gQUn); 
return false: // coniradictfon reached 

I 

if ((rslt =” kkesuitSoivedBoth) || 

(rslt “= kResultSolvedFirst 
TypeOf(clue) “ kClueLocatedAt)) 

I 

progress = true; 

Eii(i(qSat, clue): 

1 

else if (rslt ” kResiiltfJoFrogress) 

EnQC&stinUnsatiafied, clue] : 
else ( 

progress - true; 

EnQCSfStillUnsatisfied, clue): 

1 

I 

MDveQ(&stlllUnsatlsfied* gQUn): 
if C!progress) 

progress = UheckColunins (); 
return progress: 


VerifyClueSSiilBaUslicd 

//Voify each due in the queue Return true if no dues Ml to say they are satisfied 
static Boolean 

VerifyCluesStillSatisfled(ZQ q) 

I 

j^pragma unused(q) 
return true; 

1 


VrrifyNfiCxtntradknioe^ 

// Verily each lucaUon in the citm:ni block, gl 
// Return true if no locations are^ /enj (ix, , impiMsiblc) 
static Boolean 
VerifyNoContradictiorifi (void) 

I 

ZLocation *currLoc * gL; 

ZLocation ‘stop = gh + gkBlockSizeInLongs; 
while (currLoc < stop) 
if (*currLoc-H- --- 0) 
return false: 
return true: 


WriteRow 

//‘foe' has fU 5 t the bit SCI in the row po^irion that wc'tt lut>king for 
static void 

WriteRow(CStr255 row. ZLocation loc) 

r 

ZValue v; 
long i; 
rowfO] ^ 0: 

forfi = 0; i < gDins; 1++) 

I 

ZType t = FindTypeOrdered(i): 

for tv = Fi rstValueOf (t); V 1^ nil; v “ NextOf(v)) 
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spotlight Memory 


NEW 


Debugger 

Spotli^t is the first automatic memory 
debugger for the Madniosh. Instantly 
detect invalid memory accesses, memory leaks, l)ad 
:oollx)x f)aramcters, stack overwrites, memory relo- 
:3iion problems, and more. Spotlight can find prob¬ 
lems in seconds that might take you a week to fix by 
liand. 

Spotlight uses your XSVM file to automatically 
mch your PowerPC native application. Wlien 
ipotligiu detects an error it brings up the exaa 
lource code line where the error ocaimed along 
Aith stack crawls, memory views, and program vari- 
ible asage information. 

No need to change your source code. No need 
0 rerampile. No learning curve whatsoever 
S(xitligfii's Objea Code Replacement instrumerv 
ation inspects each ifowerPC processor memory 
ead and write instruction in your code as it Ls run. 
spotlight detects feulty memory reads and writes 
hat cx:cur between blocks, in released bkx ks, 
icn jss multiple Mocks, and ouLside of your heap. 





Features 

m Stops your program on exaa 
source code line where a bad 
memory write occurs 
• Complete leak reporting with 
source code stack trace show¬ 
ing point of allocation 

■ FuUy validates parameters to 
OWT 400 Mac toolbox API 
calls. 

m %rks on aO ht'ap allocations 
Mac Ibolbox, C 'malloc', 

C++ new and delete. 
m Supports any language that 
produces an MPW or 
Metrowerks XSYM file. 
m Fufilpggfog and ignore capabilities 
m API for fine tuned control 
m Purohase indudes one year subscription to 
downloadable updates 

■ 30 day money b^ guarantee 

■ Available for secure electronic purchase now 
at our web site 


rtequirementft 

Madntosf^ orAkte OS<xmpaiibk wfr^ermthaPPC 601 or 
greater prtxessor^ RAM reqmremenlsimyik(>eridiT^ontar 
gBt appOaxtim size; 2 MB hard disk space, Sy^em 7.^ ur 
M^rrywerksor MFW cumpatdjle)(S^ syrrMiepk 

Download free demo at htipy/www.ooyx-tech.cran/ 

$199.00 

TEL {^1)79^7831 E-MAIL sals#)nyx-ieckcom 

FAX (941) 795'5901 URL lffipy/www.OTpt UxlLCuny 


If ((UcatlonOf (v3 & loc) J" 0) 

[ // 3dd Lhe nsme to the line 

long len: 

street {row, NatneQf(v)); 
len = fitrten(row); 

row[lenl * 0x20; //sptJK:e between words 

rowilenH] " 0 : //RHiidkemiinate 

I 

1 

I 


WriteDowoPfobIcni 

static void 

WriteDQwnProblcmfCStrZSS clues[1, long nunClues, long dim) 

! 

long i; 

liiitStructureinumClues, dim); 
for (i * 0; i < numClues: i ++) 

ProcessAClue^clucsti]) i 


llimkRcalHird 

// Apply dues imt U no more progress cun be made, then enumeraic aU 
// remsUning possible configurations and test them recursively. Set the top-Sevel 
// location hk>ck to the first configuration that does not contiadict any facts, 
static Boolean 

ThinkRealHard(ZLocaLion *myBlock) 

i 

ZQRec newlySatisfitd: 

ZQ qNow = ^nawlySatisfiod; 

ZValue vtry; 

ZLocation trylocfl; 

ZLocation currBit: 
long i; 

Boo 1 ean p rogress^fade: 

InltQtqNow); 


//Apply knowledge 

do progressMade = ApplyEachUnaatisf lodCliieCqUew): 
while CprogressMade); 

// Test all locations for impossihility (icro possible 
// locaiions for a value meaas there was a comradiciion) 

If (false = VerlfyNoConttadlctionsO) 

{ // we have reached a coniiadictioo 

// put the newly ‘satisfied’ dues hack m the 
// unsatisfied list 
MorgeQ{qN€W. gQlln); 
return false; 

1 

// Gencnte'iind'Test 

vtry ” FindValuoWithUnsoivedLocationC); 
if (tvtry) 

i // we have no nH>ie unsolved locations; done f 

Mg tgeQ (qNew, gQUn); // put them hack so they can be freed 

return true; // might be a solution 

I 

tryloes " LocatlonOf(vtryh 
currBit “ kLeftBit; 

for (1 " 0; 1 < gDim; I'M-, currBit »" U 
if feurrflit & tryloes) 
f 

ZLocation newBlockfkMaaValues]; 

CopyLocatlons(myBlock* newBlock); 
gL " newBlock: 

// try new configuration by faking a due 
ApplyTXICATED_^T(vtry, currBit); 
PropogatelluiqueLocItlColuMiiCvtry): 
if (true = ThinkRealHard(newBlock)) 
f // this umfigtuation worked 
gL = myBlock: 

if (VerifyCluesSiillSatisfied(q!iew]} 

I // and verifies, so fiir, iq) to ihb level 
CopyLocal1on s(newBlock, myB1o ek); 
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Me t g eQ (qN ev. gQ U n); // pm them Iwtk so they can he frml 
return t rue i // looks like ii Evulution 

I 

He r get} (qMew, gQOn): // put them hade so they csiii be &ml 

return falBe: //hhkxl vcriiy 

I 

gL ^ HiyBlock: 

1 

MergeQtqNew, gQUn)j 

return false;//exliaustecj all conrigumtioas,mme worked 
I 


WriteOuiSoUition 

static void 

WrlteOutSolution(CStr255 eolutionllj 
I 

long i ” 0; 

for (1=0: i < gDim: i++] 

WriteRow(Ko]utionfi] . kLeftBit >> 1); 

ReleaseMeworyO : 

1 


WhoOwnsZebr;^ 

void WhoEhrftisZebra{ 

long p r oh 1 emD im ns ia n, /* n umber of pn>bkm variables V 
long nuraCI ues, /* numbcT of clues provided 7 

CStr2iS clucstK /* the dues V 

CStr235 solution!] /* storage for prultlemDimeasion result strings 7 
) 1 

// Dr Richard Feynmann's Prohlem-fiolvmg AJgfjrilhrm 
WriteDovnProbleQi(clues, numClues , probleraDiaeneion) ; 
ThinkRealHardtgL): 

WriteOuiSolutionfsolutionJ: 

I 

B 


Adobe Developers Association 

345 Park Avenue. San Jose, CA 95110-2704 


Developer Tools to Support 
Adobe Adobe®Technologies 

Adobe provides a complete sef of tools and 
services for your development needs. Whether you 
want to integrate Adobe Acrobat® capabilities Into 
your applications, add PostScript® language 
support to your products or aeote powerful 
Graphics Application Plug-ins, Adobe has the tools. 

These Software Development Kits now available: 

^ Adobe Ac robot Plug-mi 
^ Adobe PostScript tonguage 
^ Aciobe Photoshop® 

^ Adobe IllustratOf® 

^ Adobe Premiere® & Adobe After Effects® 

Adobe PogeMaker® A FromeMoker® 

To have information taxed to you, call {206) 628-5737 
and request document 1 220. Or visit our web poge: 
http://www odobe com/supportservtce/devrebttons 



Macintosh Programmers and Developers... 
PRODUCE and DUPLICATE quality disks 
Quickly and Economically with the “CLONE-IT” 




“CLONE-IT" 1 to 3 

t&s 


STARTING UNDER $1,000 

“The XEROX Machine for CDs- 


• 3 In 1 solution of haviTig a CD-Duplicator, a 
Philips 2x/6x Writer (3 in the 1 to 3 Duplicator 
model), and a 12x CD-ROM in one unit. 

• Stand-Alone capability for performing its 
function as a CD-Duplicator, Produces absolute 
identical brt-by-bit copi^, 

• Easy hook-up to MAG systems. Automatic CD 
format detection arxl transfer to CD-R media. 

m Simple operation with the touch of a button. 


“CLONE-IV 1 to 


CD-Recardables 

ufftn “Priniiatilit Surfnoo" 
on Spindles Of 100 Biaili CDs 


Optics Storage Re. Ltd. - USA 

1162 St George Ave., Suite 160, Avenel, N J- 07001-1263 
Tel: (732) 636-4466 Fax: (732) 750-1793 E-mail: optixsLJ&a@aoLcom 


Visit Our Web Site For Details On How To Receive A FREE CD Duplicator - www.optixs.com 
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Room for Development 

APS Technologies carries everything you need to store, archive, protect, backup, tronsport and distribute your next killer app. Listed 
below ore just o few of our most popular products, give us a call to order □ product, call for a free APS catalog; call for information... 
just call 1 •800-761 -8133. Or visit our online catalog, ol www.apstech.com for literally thousands of storoge solutions, peripherals and 
supplies. If you work in a mixed-platform environment, we've still got you covered - with Moc, PC ond NT products. 



APS POWERBOOK STORAGE 


APS HIGH-PERFORMAIVCE ULTRA SCSI DRIVES 


Model 

Oescriprion 

EL 

InL 

SR 2000 

Pro 

A PS a 2000 

QuantLiFn Fireball ST, 2079MB. 5.4K 

‘2ir 

“22r 

lar 

^23“ 

APSQaOK) 

Quantum Ftreball SI 54K 

289* 

299" 

3fi^ 

333" 

APS Q 4000 

QugniumFirabBlt SI 4136MB, S4K 

319* 

339* 

4or 

433* 

APS Q 6400 

Quanlum RrebaCI SI 6236MB. 5 4K 

429* 

449“ 

519“ 

543“ 

APS Q 4500 

tluanlerFf Viking. 4345M0, ?20(] rpm 


599^ 

669" 


APS 0 4300 

Quantum Atlas 11,4341MB. 7200 rpm 


599*' 

ser 

BW 

APS Q 9000 

Quantum Atlas II. B6S2MB, 7200 rpm 


179“ 

949" 

979“ 

APS ST 2000 

Seagate 32272N. Z157MB, 7200 rpm 


Call 

449* 

479” 

APS ST 4300 

Seagate Barracuda, 4340MB, 7200 rpm 


Call 

649* 

679” 

APS ST 4500 

SeegatE Cheetah, 4340MB. 10000 rpm 


WA 

N/A 

779* 

APS ST 9000 

Seagate Barracuda, 0683MB, 7200 rpm 


Call 

1^13“ 

1,043" 

APS ST 9100 

Seagate Cheetah, 3681MB, lOOOO rpm 


m 

N/A 

IJffi" 

APS WD 2000 

Western Dtgrtal Enterprise, 7200 rpm 


399“ 

469“ 

439" 

APS WD 4300 

Western Digital Enterprise, 7206 rpm 


599“ 

669" 

699" 


Modal _ Description _ Internal 


APS PPwerBookDnve IBM DMAA-21080,1080MB, 4000 rpm 




AFS REMOVABLE DRIVES 

Model 

Description 

Int. 

SRIODO SR^ 

APSSQ5Z00 

SyQuesL5200,190MB 

N/A 

N/A 

■389" 

APSJaz 

(with Icartridgef 1GB 

m 

*399* 

399“ 

APS MO DRIVES 

Model 

Descriplion 

SR 1000 

SB 2000 

Pro 

APS 230 MO 

(with 1 cartridge] 217Mfl ^ ^ "i 

’299" 

’369'^ 

■399” 

APS 640 MO 

Fuiil3uM2S13A2lN i 

N/A 

469" 

493* 

APS 16GB MB 

SonvSMO-F544,2.4GB J 

N/A 

1.769* 

1,799“ 


APS CD ROM DRIVES 


APS HIGH-PERFORMAf^CE ULTRA SCSI DRIVES 


Qgscftptioa _ 

SeagaLc Elite 23,211 SB, 54TO Tim 
Seagate EEite' 23,211GB, ^400 rpm 


APS ULTRA tAfIDE SCSI DRIVES 


Descripiion _ 

QuanUrm A^faS H, 4341 ME, 7200 rpm 
Quantiim Viking. 4345MB, 7200 rpm 
fkatmjjp Atfsj II. fl6a2MB. 7200 Tptii 
Seagate 02277W. 2157MB, 7200 rpm 
Seagate Barracuda, 4340MG, 72(K1 rpm 
Seagate Cheetah, 4348MB, 10,000 rpin 
Seagate Barracuda. B663MB, 7200 rpir 
Seagate Cheetah, ^SIMB, lOjQOO rpm 
Western Dtgrtal Enterprise, 7200 tjot 
W estern Digital Enterprise, 7200 rpm 


APS IDE DRIVES 


Pcscriptiflft _ 

Quamum Firebdl SI 31 f8MB. S40Q rpm 
Ouantutn Firebal ST. 4136MB, 5100 ffim 
Quamum FirebaLI SX 623&MB, 5400 rpm 


Model 


Disoriptioii 


External 


24K CO BO M in Siimlhe Case 

2X recortVHX read CO fl iSonyl 

4Xrecord/GiX read CO'B in fVo Enclosure 

2X rei:erd7EX read CO-RW m hro Enclosure 

Svsttm 2X racord/&X reed CO-R 

Sys Q 2000 Hard Drive &2X rceord /6X read CD-RW 

4X recerd7&X read CO R in Full Height Enelnsurie 


APSCD24 
APS CO fl Plus 
APS CD fi Pro 
APSCDRW 
APSJaz/CDR 
APS2GB/CD-HW 
APSCD^RPra 

JAvai/air7Q in an Sf^^OOOBnckisiire hr an stidftmai$11^.00 


APSTIKWPW 


?29‘ 


Model 


Bescriptioti 


httemal External 


APS HvpefOr Travan 4 Conner QIC 30^, BGF 

APS HyperOAT* D0S-20C, BGB 

APS HyperOAT'Pro ODS 2DC, 8GS 

APS HyperDATNII DOS 30C, 24GB 

APS Mint tJbrs ry 4mm DD S-2 AEitnLoedcr, 64GB 

APSDLT4fl DLT400Q,40GB 

APS O™ S DLT 7000,70GB 

APS Air SmmW/DC,50Ge 

APS 0L1 4MM ODS-2 Autofoader, 13GGB 


1.149r 


WA 


M/A 


N/A 


W* 

793" 

B99P 

1.W 

2.399" 

im 

6,999* 

1199* 

4,939* 


APS RAID 


Model _ Descripfioil _ Inlernal 

APS StwjftSiack Qtrantum Ultra SCSI 6GB/I2GB *U9r 

APS Hardware RAID tUigntum Ultra SCSI w/5 - 4JGS 1999* 


Technologies 
APS Technologies 
6131 Deramus 


Model _ 

APS ST 23000 
APSSTZ3000W 


Model 

APSO 4300 W 

APSQ4500W 

APSQSOOOW 

A PS S T 2000 W 

APSST4300W 

APSST45WW 

APS ST 9000 W 

APS ST 9100 W 

APSWOZTODW 

AFSWD43D0W 


Model 
APS Q 3000 
APSDW 
APS Dm 


i 

i^|[7 tVsi^Hiir^ilcrnL 1^1 Ctll)iirliinlErf>a±El fans air 
^■Bodrniaiij ufOw frspafW 


1 - 800 - 761-8133 


Ftill Height 

“1,399" 

1099" 


Int. 

SR 2000 

Pro 

■619* 

■609* 

*719* 

619* 

6B9" 

719* 

Bag- 

989* 

993“ 

Call 

439* 

523* 

Call 

699* 

729* 

N/A 

N/A 

829“ 

Call 

1.063* 

i,(ar 

N/A 

N/A 

IZ49* 

429- 

*93* 

529* 

629“ 

693* 

729“ 


Internal 

»229r 

279* 

303" 


Kansas City^ MO 64120 


































Developer Central ” 

“The Place for Macintosh Developers” 

Sponsored by 



MacWorld Expo / San Francisco 
January 6 - 9, 1 9 9 S 

AAoscone Expo Center 


At Developer Central, you can... 

r Talk directly to representatives from Apple and third-party vendors 
> Demo developer products and tools 

y' Get the best deals on tools, training, and developer resource materials 

So, no matter if you're developing a departmental system, developing 
plug-ins for the Internet, or planning the next great Mac OS application 
or multimedia title, you'll find what you need at Developer Central. 


Apple, the Apple logo, Macintosh, Moc, and the Mac OS logo ore registered trademarks ot Apple Computer, Inc. Developer Central, Virtual Developer 
Central are trodemarks of Apple Computer, Inc. MocTech is a registered trodemnrk and Developer Depot is a trodemark of Xploin Corporation. 









BOOTH 3080*NORTH HALL 

Exhibitor List 


AAA+ Software 

Adobe Systems Incorporated 

Aladdin Systems, Inc. 

Altura Software, Inc. 

Apple Computer, Inc. 

Apple Developer Programs 
Java/MRJ 
Open Transport 
Rhapsody Tools 
WebObjeds 

Bare Bones Software, Inc. 

Bowers Development Corporotion 
Conix Graphics 
Developer Depot 
dtp Americas, Inc. 


Hotline Communications, Ltd. 
LightWork Design 
MacTech Magazine 
MAGMA 

Mathemaesthetics, Inc. 
Metrowerks 
MindVision Software 
Qdea 

Quadrivio Corporation 
Red Planet Software 
Scientific Placement, Inc. 

SNAP Innovation Software GmbH 
Tenon Intersystems 


Sponsored by Apple Computer, Inc. and MacTech Magazine, Developer Central is the 
premier location for developers at Macworld Expo. This pavilion provides you with a 
one>stop location to see the latest technologies, gain new and updated product 
information, purchase products, and talk directly with the developers of the tools you 
use to create your solutions. 

Your development mission may be to create the best new game, or the most efficient 
way to manage a business. You may be developing in C++ or scripting your way to a 
solution. You might be a Web site manager or a content developer on the internet 
road to fame. 

Wherever you are going as a developer, the path to success leads directly to 
Developer Central at Macworld Expo/San Francisco ‘98. 


Visit the Developcr Central web site 
day or night for the all the latest news. 

http:// www.devcentraLcom 










hy fes^iica Courtney 


SPOlClUiCK 1,0 

Genie Works, LLC announced the release of SporCheck LO 
for the Macintosh, SporGheck is a language-based editor that 
"knows" lire Java language. It is designed to help a Java 
programmer j^roduce coiTect code without relying on confusing 
and imtitnely feedback from a compiler. 

Specifically* SpolCheck identifies syntax errors and semantic 
errors (undefined names* typ^ mismatches* etc.) — those ernrrs 
nonnally returned by a compiler. 1Jiis analysis is performed after 
each edit* giving the programmer immediate fcedl>ack on errors. 

S|K)iC!ieck prt)vides a host of addititmai features* including: 

• Smart links to name decJaraiions. 

• Cross-referenced Java APIs. 

• Editiitg with popup menus. 

“ Interfaces to helper apps to txrmpile & mn. 

• Hienirchlcal pn>ject Irrow.sing. 

• Color-coded syntax. 

<http://www.genieworks,com/> 

SnTiWAitRKiK Wages War On Web Site Comriexot 

ProVUK Development has released SiieWarriur* a new 
program that uses a revolutionary approach for authoring and 
managing medium to large web sites. 'i1iis approach makes 
HTML ccKling taster* more flexible and more produaive by 
using an ulira fa.si ItAM !>ased database to manage the structure 
of an entire web site. SiteWiirrior automates tetlious tasks such 
as building tables* catalogs, rabies of contents, navigation 
banners, links lo neigliiHiring pages, and other re|X"titivc 
elemenls within a web site. Unlike most web authoring tools, 
SiteWarrior does not attempt to eliminate I he need for HTML 
with WYSlWyt'i features. Instead, SileWarrior eiiibnices HTML 
and automates HTML production with cusKan M lTMl. factories" 
controlled by user defined templates. 

liy holding the entire web site in a single powerful 
database* all structures and links are updated automatically a.s 
pages are added* renamed* or deleted, Jhis guarantees that 
there wall he no broken links wiiliin a site. The well site author 
can search* rejilaee* or check s[ielling in a single page or across 
the entire site. Site Warrior also manages all GIF and JPEG 
images with a built in image database. 

SiteWarriof i.s designed lo work sTmxHltly with other web 
prcxJucts. liecausc SiteWiinior uses a nonAVYSlWYG* pure text 
editor* it never mrxlifies existing page tags in any way. 
SiteW'arrior works with any version of HTML and is compatible 
with JavaScript and all lirowsers* CGI's* plug-ins and applets, 
current and future. The finished web site does not require any 


special server software* and is coni|Xttible with servers on any 
platform. SiteWarrior also includes automatic KfP upUiading for 
working with remote servers, 

<http://www.sitewarrjorxorn> 

OBjECTlW-EVERVTHINr. REI.EASE 5 

'Up fop Software, Inc, announced Release 5 of the Objective- 
Everything clevelopmeiit system for (,)PHNS'ITP (Rhapsody, 
Windows, and Mach), including Objectived^thon, Objeclive-Tci. 
Ohjcctive-Fcri* and Objeaive-Browser, 

Objective-F.ver>'lIung provides true language independence 
for tile OPENSITP (Yellow' Box) object mixlel. It allows you lo 
develop programs fVir OPKNSTF.P wiihnui lieing restricted by the 
lack of expix^'.ssiveoess, class libraries, or other limitations of a 
particular programming language. With Objective-Everything 
you can use the language best suited for the task al hand* or 
even mix-and-match languages. 

Olijcclive'Everything is a develo|)nient tool for anyone 
wJk> develo])s under OPENSTEP, including programmers who 
just want to program in stniighi Objectivc-C. Objective- 
Eveiything is ideally .suited for ra]>id application prototyping 
and deveiopmeni, application scripting, regression testing* 
exploratory programming, ami much more. 

Objective-Brow^ser is a graphical UkiI which allows you to 
visualise diject.s and object-relations in a running program. This 
is a t(X)l Ibr all Apple Macintosh develojx^rs getting familiar wiili 
the OPENSHTP development envir<mmeni! 

Tfie bniwscr allows you to view live objtxls within a running 
application in many olifect-specifk w'ays. OB allows yrm to easily 
invesiig;ite the struLtuR" and methtxis of various objects and classes. 
For example, classes hierareliy, metiKxIs. in.siance variables* and 
other objecl infoniiaiion can Ixr viewed anti edital during execution. 

OB is extensible. You can provide object-specific 
browser ntnles and custom inspectors for any object in the 
system. OB is dynamicaliy loaded on demand and can he 
used from any application. 

<http://www.tiptop,com> 

NetClOAK 2.5 liPtiRADE 

Maxiim Devciopmeni Ckjrporaiion aniKiunced the relcrase of 
NetC'loak 2.5* a major revision to the Web .sc^rver tool for creating 
dynamic Web pages. NeiCloak, the first commercial Web serv'cr 
tool ever available for Macintosh* has iieen included on the 
Apple Internet Serv'er Solution for well over a year, and is now' 
included as a .standard component of Apple's AppleShare IP 5.0.2 
package. Ulie new version adcLs dozens of new caiyaliilities* 
imprewed support for the wide range of servers a\'ailahie for the 
Mac OS, belter 3rd-party tools support* and more. 
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guarantee would be cool. 

Then, someone suggested a 

30-day satisfaction guarantee 
. ..and we thought we'd do that 

too. Then, someone else called 
every vendor they could think of, 


and stocked hundreds of tools, 

books, accessories and everything 

else a developeiyprogrammer v^uld 

ever want. Then, we .set up tplidree 
phones, an awesome Web site, fax 
lines, and e.rmaj) accounts so ouj 
customers could order as cohvenierttljf ' 
as possible. Finally, some dude 
gpes: “hey, jet's just giv ' 
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E-mail; orders@devdepot.com • Web site: http://www.devdepot.com 
Phone: 800-MACDEV-1 - 805-494-9797 (outside the U.S. & Canada) • Fax: 805-494-9798 







NetCloilk is now int*lutk"d as a sumdard component of 
Apple Computer's coniplele file and Web server solution, 
AppleShare IP 5.0J. 

<http://www.maxumxom> 

DynaMorph 1,5 Appucation Server 

Moq')]! TechnolngieSt Inc, annoiint:ed that ii has released 
DynaMorph 1,5, the latest version of its flagship server-side 
scripting language, DyiiaMorph enables a website or application 
developer to employ the power of CGI programming directly 
inside of Hl'Ml dcKaiments without the need for advanced PERL 
or Ci'+ progruintning skills. With the latest release, Morph 
Tcclinologies Ls again morpliing the future of technology on the 
Web by making it even easier to build sophistieuted wellsites 
and web-basi^d applications. 

Version 1.5 rjf DynaMorph adds dnabase connectivity for all 
ODBC-compatible databaseji on Window's NT/95 and Mac 
serv^ers as well as native data!>ase support for liNtx-based 
tkitalyases. Also available with the current release are PC- and 
Mac-Auiiiorize plug-ins wliich enable real-time, credit card 
authorization directly from any Webserver. 

With DynaMorplu it is easier to ix'rform the tasks asscKuatc^l 
with website creation and maintenance as well as to develop 
sophisticated w'eivbased applications which previously required 
an intimate know^ledge of CGI programming. Examples include 
discussion forums, chat serv^ers, on-line scholastic testing 
systems, intemctive training, adaptive infomiahon publishing, 
product registration, and electronic commerce. 

DynaMon^h is the only true cross-platform server-side 
scripting engine, with support for Windows NT/95, Mac OS and 
Unix. This enables web development companies (or internal 
IS/Wfeb depan ments) to [>erfcjrm site or application development 
work on Macs or PCs, yet deliver their work to clients running 
websites, intranets and wel>based applications cm NT or Unix 
platforms, A w^ebstie or appiiaition built using DynaMorph can 
literally lx.‘ moved fi'om one computer to another, indepentlenf 
of tile operating system, ^md work automarically with no 
additional effort required. 

DynaMoiph not only eases the creation of web pages with 
dynamic content, but also greatly simplifies the maintenance of 
.static pages. DynaMorpli acconiplislies this Ijy taking a site 
creation and maintenance |>ers[)ecLjve rather than simply one of 
individual [nige creation and maintenance. 

With over 175 commands that can be embedded into 
HTMl.. Java, JavaScript, VRML and other documents, 
DynaMtirpli |>rovides the expressiveness and flexibility 
demanded by sophisticated web site development teams. Yet 
it also includes many pre-biiilt, ea.sy-lO“iise templates which 
make it immediately useful to both programmers and non- 
]irogramniers alike. 

<htTp://www.morphtech.com> 


Visit MacTcch Magazine’s Web site! 
http://www.mactech.com 


Koaster KF.tfA.SE 4 PRtM)i:t;i' Family: 

Au. Java — Cross Piatfobm and Extensibij- 

With its first announcement of derailed information 
regarding the eagerly awaited Roaster Release 4, Roaster 
*lechnologies revcraled that ilie new release is w'ritten entirely in 
Java(un), utilizes the Javattm) Koundation Classes, and is the 
basis for its Data and Enterprise Rdiiions. Release 1 is the 
cornerstone of ihe extended Roaster family of development 
software for liigh-end professional developers working in Java. 
The environment is completely extensible, enabling the 
integration of a wide variety of technologies. 

The Release 4 prt>jeci wa.s originally started using Koaster 
Release 3 on the Macinto.sh, lieavily uriltzing ihe IniemeL 
Foundation Classes from Net-scape. 

koaster is one of the first Java development environments 
to be written entirely in Java, l>ased on JDK El and w-ritten 
utilizing the Java foundation Classes. This support gives Roaster 
users a consistent development exfxmencc across all major 
operating system [ilatforms. 

Roaster products products are available through the 
Developer Depot at <http://www.devdepOtXOm>. Roaster Release 4 
is schtxiiiled to ship at the end of Ql. 199H, public lieta 
rclea.se is scheduled for Januaiy. 

<http://www.roastef.com/> 

Natiojnwode L\sso TRywiNG Course Anndijn(:ei> 

Blue World Communications, Inc. and Chris Moyer 
Coasulting, Inc. announced the availability of Mastering Lcsso 1, 
a product profidency training course for Lasso 2.0, the leading 
third party solution for web-enahling Mle.Maker Pro databases. 
Iliis m^o day hands-on course allows users to sliarpen Uteh skilLs 
and provides users of Blue World's lasso 2,0 recognition for tlieir 
knowledge and exjxmise with profe.ssional cerriflegation for 
completing Mastering Ucsso I. A follow-up course Mastering 
Lisso iJ Ls scheduled for early 1998. 

In addition to Lasso j)roduet trainings users will receive 
hands-on experience with FileMaker ITo from Claris 
Corporation, BBEdii from Bure liones Software and WebSTAR 
from Siarnine Technologies. User will alscj receive promoikmal 
materials, a Mastering Lts,so I certificate, future discounts for 
training courses offered liy Chris Moyer Consulting, future 
ccmsickTaiion for Blue World's Business Pailner Program and 
t|ualify for free Mac OS Web .software wonli <wer $L(X)0. 
<http://www.fmpro.ccm/lassotraining/> 

OpeinBase Upoaits 

OpenBase Imernafionai. l.Rl. ha.s made OfxnBase NeBvork 
and OptmBase Lite available for both the PC-G>mpatibles and 
PPC versions of Riiapsody. 

OpenBase is a high performanct* SQL engine tlial handles 
all of the complexities of data storage and niuki-u,ser 
communication for end-user apj>lications. Aggressive mulfi- 
ihreading, row' level locking, text searching, change 
notification and variable rectjrd length technology makes 
OpenBase a robust database solution. 
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OpenB;isu Lite is a FREE run time license to the SQL 
diiLal>asc. Tlie pur[X)se of the license is to allow software 
vendors to sell shrink-wrapped database applications without 
paying royalties for single itcenses. 

OpenBase Lite provides a zero administraiion datalrasc 
interface. An EOF adaptor is intended. OpenBase Lite does not 
include developnienl tools and should not be used to host web 
applications (this would violate the liceasc agreement). 

OpenBase Lite for Yellow-Box on N T will be made available 
as soon as Yellowdnix on NT is available. OpenBase Lite will not 
be available for OpenStep 4.2 systems. 
<http://www.openbase.cDm> 

New' Scripting Tool Ar>DS IM^cro Capabilities 

Nombas, fnc. announced the release of the 
ScriptEasediitegratum SDK 4.0 developers’ kit for applications 
and embedded systems. The kit enables application developers 
to enhance, extend and customize their applk'ations using the 
flexible, easyTo-u.sc\ JavaScript compatible, ScriptEase scripting 
language, fhe ScriptEase:Integration SDK allows developers lo 
quickly and simply embed a fully functional script language 
interpreter into any C/C++ application. 

Over WYo of all brow^ser client-side dynamic content on 
ihc web is already being developed with JavaScript. By 
merging ScriptEase with JavaScript, Nombas is making 
JavaScript available for all classes of software and emfieddetl 
system.s, nca just for brtiwsers. ScriptEase:Integration SDK 
leverages the populariry, pow'er and ease-of-use of JavaScript 
(an international standard under the name ’'ECMAScripr'') to 
enable developers to customize and extend applications far 
beyond their t)ff-the-shelf capabilities. ScriptEase:lntegration 
SDK provides the full power of an imerpreter engine without 
the time, engineering or hardw'are resources required to 
develop a proprietary macro language. Script Ease: Integration 
SDK allows for more flexil>le applications, improved code re¬ 
use. easier ponability and significantly reduced application 
developnienl times. 

Incorporating the ScriptEase (JavaScript) language into 
your application is a fast and straight-forward process. 
Througli .simple initializing function calls, the ScriptEase 
engine is directly integrated into your application. The 
ScriptEase:Integration SDK's BO API functions allow the 
application unlimited interaction with the script language 
and vice versa. The ScriptEase:Integration SDK offers a safe 
and controlled environment in which to access application 
functions and data and can be executed from wdthin a single 
64k segment. 

Platforms and operating systems supported by the 
ScriptEase:Integration SDK include Window^s 3.1, Window^s 
'95/NT/PFC, Linux, Uktx, DOS, OS/2, Mac OS, NetWare, and 
embedded systems. OS/390 and 100% Pure Java upgrades will 
be available in Ql, 1998, 

<http://www.nombas.com> 


Natural Intelligence Splns Ofl DragSirip; 

Macintosh Desktop 

Natural InieUigcntc, Inc. announced the sale of 
DragStrip, its aw^ard winning desktop utility for the Macintosh. 
This action reflects Natural Intelligence's focus on the 
expansion of its core custom software consulting business, 
and its newly formed Corporate Java Division. DragStrip will 
be acquired by Christopher Evans, the original creator of the 
product, who will upgrade, .support and distribute the 
product as a sharew'are product. 

DragStrip ^.O's new features include the ability to have 
muliiple tabbed pages on a strip, improved support for MacOS 
8, including contextual mcnu.s, new "Strip" .styles, easier 
c:f>nfigurarion, suppon for URLs and more. 
<http://vvwwmatural.com> 

Metrowerks Announces First Qii.\kji:r 1998 Rl^ enles of 
IJS$ 6,2 MiiiiON 

Ccimpany Records Profit of US$237,000, or $0,02 per 
Share, for Quarter 

Metrow^erks Inc., a providerof software development cools, 
rodity announced its results of operations for the first quarter of 
iLs fiscal year ending July 31, (QlEV|uly98). 

Revenues for QlFYJulyQH toiakd US$6.13 million, an 
increase of 65% over revenues of USS3.77 million ft^r the 
corresponding QIFYjuIy97. Revenues for Q4FYJuly97 totaled 
US$6.23 million. As in previous years, rev envies tor QlF'r'Juiy^B 
were approximately die same as revenues for QIFYJuly 97. 

In Ql njuly98, the Company reported a net profit of 
USS237,000 {US$0,()2 per share on a fully diluted basis), 
compared to a net loss of USS135,OtXJ (USSO.Ol per share) for the 
corresponding QlFYJuly97, and compared to net income of 
USS155rO<X) for die previous C]uarter, Q4FVJuly97. 

llie Company completed a financing during the quarter, 
whereby the Company will issue 1.25 million shares at $10.08 
per siiare. Tlie Company had a cash balance of approximately 
$15,5 million on Oaober 31, 1997. 

The Company has tw^o main revenue streams; the sale of 
shrink-wrapped software, or priduct revenues, and product 
agreement revenues, w'hereby companies pay Metrowerks to 
.support their platforms. Product revenues for QlFYJuly9B 
comprised 74 percent of total revenues, or S4.55 million. 

Cost of goods sold for QlFYJuly9B were 18%> of net 
revenues compared to 17% for Q4 FYJuI> 97. In QlFVJuly98, 
expenses totaled US$2.1 million as compared to US$2.3 
million in Q4FYruly97. R&D expenses were down slightly as the 
Company has ramped up headcount to a point where less third 
parly consultanLs are needed for development projects, 
and technical support expense.s totaled US$2.37 million in 
QlFYJuly98 and US$2.44 million in Q4F\9uly97. SG&A 
expenses were down slightly, as the Company increased its 
focus on operational expenses. 

<http://www.metrowerks.com> 
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TIPS & 
TIDBITS 


Z? V Steve Sisak 



Mere i.s a lip al:)Oui the use of the 
GetScrap .Scrap Manager trap. When your 
appliearion is starling up. you may warn lo 
check ilie contents of the scrap or transfer it 
into your private scittp. I lowever, you shoukl 
lx* careful not to aill GetScrap unMI after 
you've made a couple calls to 
WaitNexthvent. 

'Ihis delay is required to allow tile 
Process Manager to move the contents of I lie 
difilKiard from the previously active application into your 
application's process context. Also* don't forget that 
TPFromScrap Is just a wrapper around (ietSerap, and lias the 
same ra|uircineni. 

Mere is some code to illustrate the problem. Don’t do this: 

InitGtaf(&qd.theport]; 

TnIiDialog^tO)i 
TEi^'roBiScrjiEjO : 

tor {;;) 

WaitNextEvent (C * J : 

Instead, do something like this: 

switch (event,what) 

I 

(Mfie niillRvFitiT: 

I 

sonic Im fdlcCouru: 
static Bcjolean gotSoolSctap: 

if (++idieCount 3 hh tgotBogtScrap) 

I 

TEFroinScrap () ; 
got BoorScrap ^ true: 

! 

] 

1 

You’re* piohahly wondering w'hy the Process Manager 
doesn i just set up the scrap corredly w-hen it launches a new 
application? Actually it can’t because the current application 
might have data in a private scrap, which w'on’t he moved into 
the system scrap until that application receives a suspend event. 



'the suspenci event won't be received, hciwevcg until after tlie 
L'uinchApplic.'ation trap lias created the new process and 
relumed hack to the caller. The Process Manager has to wait until 
the original frontmost application lias ret‘eived that suspend 
event Ix^fore it can safely move the contents of the .system scrap 
into the launched application’s context 


Zinc Schlegel 
ericsc@apple. com 


“Kather than tiying to guess how many nullEvent.s to wait 
for. it may be more reliable to hold off importing the scrap (and 
other initialization) until you receive your first Apple event. That 
first Apple event wall lie either 'aevtY’oapph 'aevt’/' odoc'^ or 
'ascT'/’ noop’ and wail not Ixr sent until the Proce.ss .Manager has 
fully suspended the previous fnmtmosl application," —ed sgs 

Eric replys: 

"'lliat w'Oiiid have ihe .same effeei. It might not always Ix^ 
a better choice than just wailing for the null events, though, 
depending on whether you already have Apple event handlers. 
Stickies opens its data file immediately wathoui w^aiting for an 
oapp event, so for Stickles and similar apfis it makes sense to 
just use the idle count." —eric 


Want to share a tip with the conimiinity 
and get paid for it? Send it in to 
<inailto:tips@mactech.com> 


m ytmr iips ur iwti inskiU EimiBeiierlkidimjr on your machine! On the other batul, tw might just pay )f(d( S25 for each tip u?e latCj or $50 
for Tip of the Month. >d?i can take your mmrcl in good% mbi^cnptkm or US$. Make sure my code compHes, and send tips (and where to mail 
}K.)Ur fi inmrtgs) to oarTips e-niail addt^ss at tipsf^nactcch com. (See page 2 for our other addrmesj 
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MACTECH 

ONLINE 


Nicholas C. ''nick.c'' DeMello <online@mactechxom> 



Rhiipstxly is a stable, modem, fully preempted and nieiiK>iy- 
pn)tcaed multitasking environment with built-in capabilities for 
symmetric multiprocessing. It's better than sliced bread, ktxiler than 
James Dean, and hotter than an LA freeway in July. It’s also not 
finished yet. On the other hand, Mac OS 8 was released in July of 
1997, and over 12 million people bought a copy in the first two 
weeks it was on the market. Over 2 million apples were sold by 
week four, and that numl')er is still growing. This month, we're 
going to take Mac OS 8 for a Lest drive. 

Kicking the Tires 

Apple shipped Mac OS 8 in the August "97 developer mailing, 
so odds are you have had mum time to explore it. If you tkm't 
subscribe to tlie mailing, you may have tmiered a copy fern the 
Claris wchsiie or got an idea of the new interface features from one 
of the five online reviews of Mac: OS 8 listed in the Yahoo index. In 
any case, you’U want to keep an eye out for updates and piiLches. 
Apple has established a Mac OS 8 website, with a page on late 
breaking news of any ‘Unintended features" iliiii may crop up. 

Speed comparisons between Mac OS 8 and 7.6 are online at 
tlie MacSpeedZcine. There are MacBench and Si^edomeier results, 
as well as real world tests including times for file co[>ying and 
opening Photashop files. Pile copying was enhanced by more than 
300%, and 12 mb of data can be deleted in one tenth of the time 
under Mac OS 8, Enhanced performance and new feature.^ are 
nice, but the real test of a produa is it's Easter eggs. ITe Ix^st Mac 
OS 8 egg involves die crayon color picker tcx)]. Take a close look 
at die crayons, then set your dtxrk ahead to the year 2001 (even 
Apple's Easter eggs liave no fear of the year 2000). Pop open the 
color picker again, and you1l see that the crayons are worn down 
(from 3 years of use no doubtFor a list of other Eiister eggs, 
installation tips, and links to Mac OS B specific shareware clicck 
out Dunc:an Crombie's Mac OS 8 Downloads and Tips page. 

Order Mac OS 8 Online 
< http://www3. cf ar is.cQm/Tnacos8/> 

Reviews of Mac OS 8 for the User 

<http://wwwyahoo.eom/Computers_and_lntemet/Software/Reviews/Titles/Opefating_ 

Systems/MacOS_B/> 

Late Breaking News about Mac OS 8 
<http://mdcos.apple.com/macos/latebreak/> 

Speed Comparison, Mac OS 7.6 vs 8 

<http: //maespeed/one. n eig J tc. net/Compa rison/OS M acBench. h im l> 

Layne KarkrufPs Desktop Consoles Collection 
<bttp://www. b I uesky hea rt.com/dc,htm l> 

Mac OS 8 Downloads and Tips, by Duncan Crombie 
<h ttp://www.ozemail. com. an/ -dcrom bie/fnacos.himf > 

Under the Hood 

Apple's Teclinote 1102 is an essential read for programmers 
taking on the new OS. It presenLs a uible of over 100 hyperlinks 
to detailed de.scripiions of Mac OS 8 changes. Valuable 


enhancements to existing technologies are documented, like the 
new drag flavors for the Drag Manager which allow you to limit a 
drag into the finder to only the trash, or control the name of text 
clippings Ixing moved to the desktop. Tlie teclinote also provides 
links to SDK's for powerful new teclinologies like contextual 
menus and the appearance manager. 

Some efTort will be involved in adapting your oirrent product 
to Mac OS 8. With the new plaiinum look and the Appearance 
M;inager, new issues of liuimn interface design have surfaced. 
Additions and changes in the Macintosh Human Interface 
Guidelines have been compiled and posted to Apple's inside 
Macintosh weKsite. An unofficial list of appliaitions that are having 
trouble with Mac OS 8 is posted at MacOS8.com, scanning ihis list 
may give ytju ideas of wriere your own code will liave trouble. To 
hel[i you fix any pniblems, Apple has provided a web page of 
developer tools for Mac OS 8, including a link to the new MacsBug 
(only version 6.5.4 or greater operates correaly in Mac OS B). 

One of tire nrere promising new lecrinologics in 8 Ls contextual 
menus. Apple's Advanced Technologies Group has used this 
teclTnoIogy to cTCife Apple Data Deteaors. 'Hie Internet Address 
detators allow you to select text in any dtx’ument and activate 
contextual menas (amtiol-click). Detectors parse Qie text data and 
identifies any eMail addresses, FTP, HTTP, or newsgroup descriptions, 
llien a contextual po|>up menu allows you to bunch the appn>j>riate 
client tool. Check out die data ctetectors and the ATG %vel}site, to get 
ideiis for your own use of the contextual menus tcdmology. 

lechnote 1102 on Mac OS 8 
<http://devworfd.apple.(;om/dev/technotes/tn/tn 1102.html> 

Mac OS 8 Modified Human Interface Guidelines 

<http://gemrT]a.a ppl e. corn/ dev/ lecfi su p port/i nsidem ac/Hl G OSSG tjide/thig-2.litml> 

Mac OS B Incompatibility List 
<http://www.MacOS8.t:om/incompatibility.shtml> 

Developer Page for Mat OS 8 
<http://devworfd.apple.CQm/Mac0S8/> 

Apple Data Detectors 

<http://www.alg.appie.com/research/tech/AppleDataOetectors/> 

<http://applescript. apple.com/data_detectors/> 

Down hie Road 

The next incremental ujxlaie of the Mac OS will lx: version 
8.1, expectcii between December 1997 and January 1998. 
Rumors are already circulating, and the latest gossip has been 
collected at the MacOS Rumors website. However, if youVe die 
one guy out there* disappointed in Mac OS 8, there is at least one 
other t>plion, Yves Lempereur has updated his TRS-80 emulator 
for Mac OS 8. Space invaders anyone? 

Mac OS 8.1 "Bride of Boster” Rumors 
<http://wvivw, macosrumori com/macosinfo.shtmb 
Yves Lemprereur's TRS-80 Emulator for Mac OS 8 
<http://www. pacrficnet.r>et/-skyrider/trs80 .html > 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech* Magazine and 
Apple’s develop" issues 1-29! 



... in THINK Reference format! 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

Includes Apple develop issues 1-29 

Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for lightning quick access! 


• New hyperlinks between articles 


• 100-*- MB of source code — use them in your applications, with no royalties! 


• Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-Vl 


• 80MB of FramcWorks/SFA archives and the most complete set of Frameworks 
archives known 

• Sprocket”! MacTech’s tiny framework that compiles quickly and supports 
System 7.5 features 

• The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 

• Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.corn • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside the U.S. & Oinacia: 805494-9797 • Fax: 805494-9798 


MacTech is a registered trademark of Xplaln Corporation. MacDev-1, THINK Reference, Developer Depot, Sprocket, JavaTech, WebTech, BeTech, and the MacTutorMan 
are trademarks ot Xplain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property of their respective holders. 






THE 

CLASSIFIEDS 


SERVICES 


Great Products Deserve Great Docs! 


DnrumcniuiiAn b* an integral part of 

your prodwt not m afterthoiighL Man ual 
r-abor in end-uM^r document^' 

lion for Madntnsh* prodtirts, including 
llallnon tHpand AppteGuide. I ITMLor 
PT7F flnd the ever-popular "diNid tiec 
cdltinn.*' Ami while we're documenting 
every nock and cranny of your product, 
wo can simuhancDUKty provide 
usabUKy feedback, n^uttmg in fewiT bugs* 
a simpler user interface, itd nerd 
cnsl$, and better reviews. 


Contact ua today to tap the tfKperUHc our 
beam has already brought to cumparues like 
Kartr Bk^us !xiltwate, id Softwarv, HtsNovsi 
Software, Management Softwan', 
Knowledge Systrans, and Scantron Quality 
Compu ters. And see why we're the best 
choico to document yuKrnext Mat pruduct, 

Jerry Kindall 
blU/445JM77 
kindalh^nrianiiaf.cnm 
h 16 pi / / www.maniLiLcnm / 


NflHIlfll lORIID We Wrote the Book! 

llllllUllU UllDUII h^dntofJi Tcthtiiati Omintumiutiim Ewp^ri^ 


The Law Office of Bradley M. Snidec»u_it 

California Lawyer focusing on Intellectual Property, 
Corporate, Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-mail. Reasonable fees. 

( 310 ) 5534054 
Brad@Snidermati.coni 



Professioiial software developers 

looking for career opportunities 
should check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Rix 800- 
757-9003 eMailrdas @scienti fic.com 

Scientific 
Placement, Inc. 




The fastest, cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mail: marketing@devdepoLcom 
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by deeje cooley, San Francisco, CA 


Introducing PuppetTime™ 


Digital actors and bow to 
add new media types to 
QuickTime 

iNTROmiCnON 

31) media is very exciting lo use, hut for 
most users is beyond their ability to create. I 
definitely lx:licve that 3D is tlie medium of 
Lite futuie. Yet, I am a>nstantly frtistmted by 
tiic learning curve as.s(K iaied witlt higli-end 
30 modeling and aiiiination tools, tor 
pn)fcs.siona!s, iliese iwh are the cream of 
tJie crop. I want something a little more 
progressive. I want to iTianii>uiatc 3D obfet^s 
that know how to animate themselves and 
lliat can internet with each other. Drag a dog 
onto a stage, tiien tell it to wag its tail. Drag 
a ait onto a stage, then tell it to walk 
around. Put tfic two together, and tell the 
dog to chase tlie cat. In short, 1 don't want 
to make 3D objects, 1 want to use* 3D objects 
to create odier dungs. That’s why I've 
created tile PuppetTime architeaure, 

Fuppet'rime is an open arcliitecture 
for digital actors, liuill on top of 
QuickTime, What, you may ask, Is a digital 
actor? You may have heard the term before. 
In its most basic tiefiniiion, a digiuil actor Is 
a graphi<‘ representation on the computer 
scTCcn that can accept messages to animate 
itself. 1 use the term puppet to mean digital 
aaor, liecause 1 want to emphasize the 
meUifilior of virtual strings controUing a 
sha[')e's appearance and implied Ixihavior. 

Here’s an example: on iuy computer 
screen f have a humanoid-sliaped pi^ppet 


and a list of commands. When I click on a ctimmand, it Ls sent to 
the [rujjpel, which then responds with some kind of activity. If 1 
click on “walk” and then dick on a new kxution on the screen, 
the puppet will "walk’* to that new location. If 1 click ‘'wave’*, tiie 
puppel will wave to say hello. Differeni puppets might animate 
themselves in different ways to repa!.senl “walk" or “wave"; the 
power lies In the fact ihal "walk" and “wave'’ are now abstracted 
out and any numlier of puppets can understand these commands 
while presenting a unique visual appearance for each. 

There are many companies now developing digital actors for 
use in movies and games, but as of yet there is no propexsed 
standard framework that might make the conimert:ial acceptance 
and dtstribution of digital actors fea.siiilc. Tlie PLippet'fime 
architecture attempts to address tliis need, 

PuppetTime u,sc's ihe Component Manager and QTAtoms, 
defines a new' component interface called puppeLs, and includes 
ixHh a deiived media handler and a movie import component. 
Tile PuppetTime framework Ls designed with a philo?K>phy 
similar to QuickTime: it contains a set of tfxilbox routines for 
manipulating the PuppetTime media data, as well as a number of 
extensilile components and c:oniponent interfaces. Much like 
Sprites and QuickTime Music Architecture in QuickTime, 
PuppetTime can l>e used by itself in your appiit:ations, and it can 
also be contained in QuickTime movies alongside other media 
types like music, text, sound, and video. 

You are liighly encouraged to liave a copy of the 
PupfX.*iTinie Sample Ctxle on hand while reading this document, 
as I'll refer to its contents often. You can dmin the sample code 
at <http://www.pyppettime.com/>. A royalty-free licen,se is avaikible 
for the PuppetTime runtime, and third-pa ny and ct>-development 
is highly encouraged, 

Basic PoppitiTime ARCHiTEfniRF. 

The Puppetl'inie architecture is implemented using several 
Q7'ML technologies and defines three key elements; ptippeLs, 
events, and the c:onductor. 


dcx’je t-txjJe)' is passionate alnjul musk, visualization, and cinema. Puppet'Hmt* Is 11 it* Result of tius passion, which he's l)een 
developing independently for almost two years now. In this spare time, he an.swers Quickl'ime ejuestions in DV> at Apple 
Computer, Jne, You can ieadi him at deeje@poboxxom. 
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Puppets 

Pupjxri components are defined and iniplcnicntcd using the 
Coniponent Manager 3 0 and display themselves using 
QuickDraw 3D 1.5.x. The puppet ta>mponent interface and 
several of the built-in puppets are discussed in detail below. 

Events 

A PuppetTime event is a QTAKim dam structure that 
c<mtains information aixJUt a command or action that a puppet 
should jKTfarm, When a puppet receives an event, il pulls out 
the relevant infonnaiion and (often) performs some form of 
animatirm. A stream of events can come from numerous sources, 
such as from a network connection, or from a QuickTime movie 
track. The standard PupfxHTirne event format, toolbr^x routines, 
and some Ivasic event voc'ahularies are discussett lielow. 

Conductor 

Ihe PuppetTime conductor c:omponenf acts as the glue 
lx:Lween events and pupjiets. At its basic level, the tonductor 
creates the QuickDraw 3D environment, iastantiates a numlx^r of 
puppets into the envimmuent, and then recteives a stream of events 
from an external source and re-direcis tliem to the individual 
pup[Kls, Again, the PuppetTime conductor Is discussed lx:low. 

Goals ov PufpeiTime 

Tliere are several key de^sign goals for PiippciTimc lo enstire 
its acceptability and future growth. 

Open Architecture 

Pupt>elTime is designed to be an open arcliitecliire. The 
format for Pupix^tTime events stRimires allows for a variable 
number of bits of infoimation, so that new events can be defined 
and existing events augmented. 'ITie puppet coiriponenl interface 
allows new puppets to be added seamlessly to existing 
Puppefrime-sawy applications. 


Scalable Performance 

PuppetTime perfonnance sc'ales with improvements in CPU 
speed and internet bandwidth. Because puppet.s animate 
lliemselves in real-time, their visual displays can improve with 
faster computer systems. Also, faster Internet connections allow 
for richer, higher-fidelity event streams. 

QuickTime Integration 

PuppetTime is designed to work as a new media type within 
QuickTime, lb start, lhjpj>etTime includes a MIDI file importer 
and a media handler, which allows PuppetTime event streams to 
be stored and played hack within a QuickTime movie, alongside 
other media types (e.g. music and text). 

Tfxnmuycy Map 

Figure 1 shows the basic QuickTime architecture with the 
integrated l^ippetTime media type and its related components. 
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figure L PuppetTime inside QuickTime. 


Compact Data Format 

Ihe PuppeiTune event format is crafted to allow for the 
witlesT range of event vocabularies possible, while keeping an 
eye towards compactness, Puppetllme uses events as meia-data 
to recreate a scene at runtime, and as such, events are much 
smaller than pre-rendered, compressed image sample.s. 

IntefiieFfeady 

PuppetTime is designed with web- and intemet-sawy 
applications in mind. For example, on-line 3D comic strips 
would lx: possible by dow'nloading a set of puppcLs once, then 
delivering new epLsodc,s on web pages as QuickTime movies, 
Fach episcxle movie can be signifKanily smaller than a pre- 
rendered 3D scene, because it only contains a sc<iucnce of 
events. The puppets themselves can be designed and 
implemented such that they am update themselves with new 
capabilities on the fly in numerous ways. 


Evenly 

Let’s begin our detailed dLscussian of PuppetTime with 
events. As mentioned above, a PuppetTime event is a QTAtom 
struclure which contains bits of information that describes an 
acLitrn or command to a puppet. 

QTAtoms 

Q'lAtonis ate structures that slorv^ a variable number of nanie- 
datii pairs. They are simiLir in concept to AppleEvcnt lecoats, except 
that QTAtoms do not .store data type information, and the API is 
available for all platfomts diat QuickTime supports. Ihe Quick'lime 
3.0 developers guide describes QTAtoms in detail, and can lx* found 
at <http://quicktime.apple,com/>. As .shown in Figure 2, QTAcoiiiscan lx: 
nested in,side one anotlier to create hieraichical daUt structures. 
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Figure S PupfjcHTiine etmtt stmcture. 

A PuppetTime event includes the following atoms: 


Figure 2 A typical QTAtom structure. 


Listing 1 shows how lo create the QTAtom structure shown 
in Figure 2, Note that proper error checking is not included in 
the listings below, but you should always check for 
programmatic and nintime errors in your c:fxle. 


Listing 1; Building a typical QTAtom structure 

QTAlyiEiContainicr aConta i ner = ail: 

QTAtom anArom = niJ; 

long along = n: 

f/ male tlie Q'lAioiiiComaincr 
aoF.rror = QTNewAtomContainer (SaCoatainer): 


// add some name-data pairs m the rfxH 
along = 7 : 

anError ^ QTlnsertChiltl [ 


aContainer♦ 

0. 

'data', 

K 

0* 

sizeof (aluiig) t 
&aLong, 
nil): 


// Uie container 
// tire aiom, zero - miit 
// ttie nmm 
// the in 

// the index of namedD pairs 
// the size of Ihe data 
// the ptrinier to tlie data 
7/ returns a ref to rite new QTAtom 


along = 3; 

anError = QTTnsertChild(aContalner, 0» 'data'. 

0, sizeof (along). fitaLong. nil); 


fj create an empw atom 

anError = QTlnsertChild(aCuiJtainor* 0. 'inore'l 
1* 0. 0, nil* ^anAtorn); 


// add some attims it 
along 2: 

anlrtor QTlnsertCJiild (aContainer* anAtorr. 

1* 0, s j z-eof [along). ^aLong, nil): 


along 14; 

anError ^ QTInsertChild(aContainer* anAtoin* *xlra'* 
I* 0. sizeof(along). ^alongH nil): 

// make sure to dispose ol It when yiiii're done 
anEtiror = dTOisposcAtomContalner(aContainer) : 


Basic Structure 

Thus, a Puppefltoe event is a QTAtom structure witli a 
well-defined set of name-data hierarchy, shown in Figure 5 
(QTAtom IDs arc nt>t used by the PuppetTime toolbox routines, 
and will be omitted from the following figures). 


• target: this atom contains an ID of the target puppet for this 
event. Pup|>et IDs are assigned to puppets at runtime, so any 
puppet can l^e used, and the event always goes to the puppet 
with the given ID. 

• time: this atcjm coniaias ilie time that this event should o<.x:ur at. 
This time value will be either relative to the start time of a movie 
or to the system ckxrk. Tlie pupfxf is rcspoasible for queuing 
this event until the given lime lias arrived. A queuing method is 
prtjvided to any pupix^l that wants it (explained later). 

• messages: each event contains one or more messages. Each 
message contains a message dass/code combination and zero 
or more parameters. In this way, a number of messages can 
be sent to a puppet with only one event. 

• class: contams the me.ssage class licing invoked (e.g. 
*core' or *musi'). 

• code: contains tlic message code, (e.g. 'walk' or 'wave'). 

• data: each message can contain a number of parameters, as 
defined by the creator of ihe event suite. The parameters can 
augment the resulting behavior and/or animation (e.g. speed 
of walk, or exaggeration of wave). 

There are constants defined in the header file 
PuppetTimeEvents, h for the event and message names used to 
build a PuppetTime event, to ensure itiai all events have the 
same structure. 

PuppetTime Toolbox Routines 

As noted above, you can use QuickTime Uk)11x)x routines to 
build QTAioms as PuppetTime events, as long as you stmcture 
the QTAtonis in the basic format described. Because the format 
is so specific, there are a number of PuppetTiine toolbox routines 
that make creating and parsing PuppeiTime events easy. Look at 
the file PuppelTimeEvents.h for a complete list of available APIs. 

Music Events 

As an example, let’s describe a class of events that represent 
music. Figure 4 shows a typical music event structure. 
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Figure 4 . A typical music emnl. 


Listing 2 shows how lo use the Puppet'l'ime toolbox routines 
to build the event shown in Fijjure 4. Notice the PuppetTinne 
totjllxjx streamlines ilte hierarcliical nature of tile event for you. 


Listing 2: Creating a music event 

QTALnmGontairier MakeAMualcEvent [) 

\ 

SInt32 instrument I: 

Slnt32 eventTlme “ 15: 

UIntl6 noteNumber: 

[ilntlfs noteVelocity: 

QTAt oniGontjg i ner anKverir ■■ nil; 

QTAlomConLaliier EtMoBsage nil; 

OSStatus anError = noErt; 

// create a new racssa};c 

aMessage = PTfJewMessage(kPTInstnmentClass . kPTKot©Event) : 

// insert the paranietefS 
riotefJumbGr ” 60; 
tioteVelocity = 0 

anError = PTSetFroperty(aHessag€» kNoteNumber» 

sizeof (noteJJamber) » ^noteNumber): 
anError = PT3etProperty(aMessage* kNoteVelocity^ 

sizeof(noteVelocity)* &noteVelocity): 


// OTGite file event 

anE vent = PTNewKvarit [ inL rumcii L , 
eventTime, 
aMessage): 

// add the fsccimd mcsNaj^c 
noteHiimbe!: “ 62; 
noteVeloclty - 90; 

anError - PTSetProperLy(aMessage♦ kUoLcNumbcr* 

sizeof tnoteNumber) . tinoteWumber); 
anError = FTSetPropertyCaMessage. kWoteVelocity* 

sizaof(noteVelocity). &noteVeiocityJ■ 

anError = PTSetNthMessage(anEvent, 0, aKeasage); 
anError = PTttoleafloHonfiagefaMonaagn) : 

// do somcthiiig with die event, like add it ro a mck 

anError - PTReleasoEvent(atiEvent): 

return anEvent; 
f 


Optimizations 

To minimize the size of PuppeiTime event streams, there 
are a number of optimizations that can be made when storing 
or transmitting events. 


The first optimization is the concept of default values. When 
an event is defined hy an author in a header file, certain 
parameters will be defined to have default values. When a 
developer creates an event, she can omit certain parameters to 
save space. When the recipient of an event goes to read those 
parameters and finds none, she can assume a default value. So 
for the music event example above, the default value for the 
velocity is zero, and that “note ofP messiiges can contain one less 
parameter. The savings can add up quickly in a Puppetlime 
track that represents a song visually. Default value optimizations 
should \xj done l)y Uic creator of the events. 

Tlie second optimization is the concept of e\Tnt flattening. 
Often limes an event will contabi only one message, so the contents 
of the message atom (class, <'ode, and parameters) are moved into 
the event atom, and tlie message atom is removed. The PuppetTime 
ttx)llx>x routine FI OptimizeKventList pertbnns event flattening. 

Fuppeis 

Now we turn our attention to Pupj^etTime puppets, 
Pupperrime defines a puppet component interface in the file 
PuppetTimeComponents.h, and also includes a numlier of [>uppet 
ctfinponcnts tltat are used tliroughout the Pupi>ecTiine environment. 


The Puppet Ofinponent Interface 

Listing 3 shows the component interface for puppet 
components. 

Listing 3: The puppet component interface 

paisral CompQnontRpHtjlt PLippetlnitiallze 

{Pupp(5tContponfint piippor., 

CaiiductorCumpotieiit aConductor): 

pascal CoinponeiitResult PuppetsetTimeFonnat 
(PuppetComponent puppet, 
aint32 eventTimsForraat); 

pascal Coiiiponont Rasul L Puppet Idle 

[ PuppeiComponGn L piippe L * 
bint32 atMediaTime}; 


// mesjiage ruutines 

pascal CompanfintRsault PuppntProceasActionEvent 
(PuppetCoiaponent puppet, 
QTAtoi&Containfir anEvsnt) ; 

pascal ComponentKeault FuppotFrocessMe^ssage 
(PuppetComponeiit puppet. 

UInt32 atM&diaTime, 
QTAtomContainei: aHessage) : 

// QD3n mutioe'i 

pascal C 0113 po nen L Re suit Puppet Submit 

(PuppetUumpenent puppet, 
TQ3View0b]ect theView); 

pascal GomponentResult PuppetGetGroupObject 
(PuppetComponent puppet* 
TQ3Groiip0bject * aGroup): 

pascal Componentkesult FuppctGctTransIateObjcci 
(PuppetComponent puppet* 
TQlTransfDnnObject* aTransforci) ; 

pascal ComponentResuit PuppetGetCametaObject 
(PuppetComponant puppet, 

Rect* graphicsBox. 

TQSCaitiGraOb jecL* aCaitiora) r 
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The key routines are described belt>w. 

• Puppetlnitiaiize: this routine is called when an instance of 
the puppet IS created* llie puppet should initialize its 
imcmal structures, which usually includes creating some 
geometries in QuickDraw 3D that serve as the puppet's 
basic visual representation. 

• PuppetProcessActionEvent: this routine is called when an 
event is dispatched to a puppet. The puppet should check the 
time of the event and queue the event if the current time is 
less ilian die event time. 

• Pu[ipetProcessMess;ige: when a pupj^et decides to execrulc an 
event, it should send all messages to this routine. Tliis alistraction 
between prtx;cssing an event and a message will Iiecome clear 
lx;low when we talk aliout the Imse puppet component. 

• Piippetldle: this routine is culled repeatedly while the puppet 
is active, and the puppet should do whatever processing is 
necessary. Often times, in response to an event, the puppet 
will animate itself, and this is the routine that should handle 
the next “frame*" of the animation sequence. It is up to the 
puppet It) decide liow to implement it\s animation. Most 
pupfxrts jx^rfonn their animations l>y adding, changing, and 
removing geometries in Llie QD3D enviromTient. 

• PuppetSubmit: this routine is called for each puppet wlien tlie 
3D environment is being drawn. The pup[XH is responsible 
for submitting its Quic'kDraw 3D geometries. 

Base Puppet 

As you can see, there are a nurnlx^r of routines in a puppet 
component, and every puppet should implement all of them. But 
most puppets need the same internal oiganizations, like a queue 
for events that aren't quite ready for pnK'essing. Also, proces.sing 
events and pulling out messages is the same for most pupt^ets. 

To make the prtjcess of clearing a new pup|xl for 
PuppelTime easier, most developers can create a derived puppet 
compr>nent. A derived puppet uses the services of a base puppet 
component as a delegate to ius own code. Sinrilar in concept to a 
base media handler or a base image decximpresstjr, the base 
puppet component implements the basics of a puppet, and leaves 
the sixcifics of the geometries and animations to the developer 

To create a derived puppet component, a develofx.T must 
implement the following puppet component n)uLinc.s: PuppetOpen, 
PuppetClose, Puppetinitialize, Puppetidle, and PuppetProcessMessage. 

The PuppetOpen routine should make an instance of ilie l)ase 
puppet componeni and set derived puppet component to lx the 
target. Li.siing 4 shows a simple derived PyppetO^xn routine. 

listing 4: A derived PuppetOpen routine 

pa^cai ConippnetitRt'Eiil t 

PTBlockyPuppetOpeii (ConponentInstance seif) 

1 

ComponentResuit result = lioErr; 

PTBLPrivareGlobals*‘storage “ NULL: 

storage * (pTBLPrivateGlobals**) 

NewHandleClear(sizeof(FTBLPriva teGlobaIs)); 
if (storage T= NULL) 


// our gtobab in the component instattcc 
SetCoDjponentinstanccStorageiself. (Handlt?) storage); 
(••storage).self = self; 

// get Che Blocky media hantlJcf component 
(•‘storage)-delegare = OpenDefauttCompouent( 

PuppetComponentType, 
BaaePuppetContponentType): 
ComponentSetTarget((*‘storage)* delegate, self): 

// iniiiaily we larger ourselves 
(“storage) .target “ aelf: 

) 

return (result): 


In PuppetClose, make sure to release your instance of the 
base puppet. 

In Puppetlnitialize, your puppet component must call through 
to the base component, and then create some geometries, listing 
5 shows a simple derived Puppet!nitlalize routine. Notice that the 
base pupjxt creates the QDiD gniup object, and that the derived 
[)uppel asks for it using the puppet component routine 
P uppetGetG roupObject. 


risting 5; A derived Puppetinitialize routine 

pascal Component Res lilt 

PTBlockyPuppetInitifllize fPTBLP r1 vateGlobals‘* storage, 

Component Instance aConductar) 

1 

TQ3Croup0bJcct aGroup - nil: 

TQ3Ceometry0bject myBox; 

TQ3BoxData myfloxData: 

TQlSetObject faces[6]; 

short face; 

TQ3CaiorRGB faceCoIor; 

TQlCoiorHGfl f sceSeoThrn: 

ComponentResuit anError; 

anError = PuppetInitiQlize((*‘storage).delegate, 

aConductor); 

anError ” PuppetGetGroupObject( 

(“storage) .target. 

&aGronp); 

// set up die colored feces for the box ibm 
myBoxData.faceAttribuleSDt " faces; 
myBoxData.boxAttributeSet - nil; 

// set up some color inTommilof] 
faceColor.r = faceColor.g “ faceColor*b = 0.8; 
faceSeeTliru* r “ kNoteTtansparency; 
faceSeeThru.g “ kNcteTransparency; 
faceSeeThrn-b ^ kKoreTranspatency; 
for (face = 0; face < 6; face++) 

i 

myBoxData.faceAitrIbute Set[face) 

= QJAttributeSet^NcwO ; 

; :QlAttributexSet Add CmyBojtData. fact'Al t r ibutaSet [facej, 
kQlAttributeTypeDifluseColor. 
ifacnColor): 

: iQ3AttrihuteSei_Add(tnyEoxData.faceAttrlbulGSct [facel. 

kQlAttribuT cTypeTransparencyCoior, 
&faceSeeThru); 

I 

// SCI up le basic pn^pcriies of the l>ox 
:: Q3 l*oint3D_Sc t (iroyBoxData. origin, 

0. (6 ‘ kHoteSize), 0); 

: :Q3Vector3D_Set (ifjyBoxData .orientation, 

0. 12 ‘ kNoteSize, 0); 

;;Q1Vecto rlD_Set(AmyBoxDa t a * ma jo rAx1a, 

0, 0. kNoteLongth); 

:: Q 3 y ec l o r3D_Set (£iiiyBoxData. min o rAx 1 s, 
kNoteWidth, 0, 0): 


// ocait the box Hsrif 
myBox = : :Q3Box_New{fiifny Box Data); 

;iQBGroup AddObject(aCroup, myfiox): 
::Q30bJect DisposetmyBox); 
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// dispose' of the objects we created Jieie 
for( face “ 0; face < 6: face++) 

< 

if (myBoxData.faceAttrlbuteSet [face] I” nil ) 

: :Q30b]«!Ct_Di spose (myBoxData * faccALLrlbote Set [face])' 
J 

return anErrctt 

I 


In the routine Puppetidle, you can do whatever idle time 
proc'essing you like, just tnalce sure to give the base puppet .some 
idle time as vs^ell. LLsimg 6 shows how. 

Listing 6: A derived Puppetidie routtne 

pascal Component Result PTBlockyPuppetldleCPTELPrivateClobals*- 
storage, 

Clnt32 atHediaTirae) 

( 

ComponentRasult anKrror: 
atiEtror = PuppetTdl p( (*’.■rroraBe) .dolcgaic, 
a LMedlaTinie) ; 

for [ahorL i ^ 0: i < k^JumbetOfNatea: l+f) 
i 

if (( “storage) . tNotes [1] !“ nil) 

I 

anError “ (“storage) .fUotesf I)->Tdl oCai Mod LaTIjitc): 

1 

i 

return anErrort 


When the base puppet decides to pull an event from its 
tjueue, it reads each of the messages inside ii and sends them to 
PuppetProcessMessage. This is where your puppet can receive its 
messages and perform its animations. Notice that the switch 
.statement defaults to calling back into the base puppet, which 
can liandlc cenain basic messages on its own (e.g, "locate at"). 
Listing 7 shows an example. 

listing 7: A derived PuppetProcessMessage routine 

pascal GomponoriL]t<5£iulL 

PTBlockyPuppetPrucessHe ssage( 

PTBLPrivateGiobais“ storage* 

UInt32 atMediaTime* 

QTAtomCoutainei: aMesnage) 

[ 

CotnporientRe.riLJl t anError ^ noEttr 
OSType messageCudt: 

::PTC e tMe s s a geCo d 0 (a Mes sage. &ms s s a ge Code): 
switch (messageCode) 

[ 

case kPTNateEvent: 
t 

anRrror " L^tocessWuLtiMessage [storage* aMeasage); 
break: 

) 

default: 

anError = PuppetProcessMessage( 

(“storage) .deleguLe. 
aiMcdia'fiinu, 
aMeSiJage) ; 

break: 

I 

return anError; 

) 


As you can see, a base puppel handles a lot of the details 
for you, allowing you to concentrate on implementing your 


pyppcLs visual appearance and animations, Also^ note the object- 
oriented nature (i*e. inlieritance and oveniding) of using a base 
puppet inside your puppet. The Componeol manager was 
designed specifically for this kind of use, 

Camera Puppet 

Another important puppet in PuppetTime is the camera 
puppet. This is a derived puppet which provides a view of the 
PuppetTime world to the user. Any puppet can have a c:amera 
view associated with it, althougli it's not required. Tile camera 
puppel is special in that it has no geometry associated with it* 
and simply provides a view. 

1 he file PuppetTimeCameraEvents.h defines a vtJcabulary for 
camem control, and the file PuppetTimeEvents.h include.s the core 
vfxrabulary for ha,sic movement. This means that the view can l^e 
clianged by sending “move" events to the camera puppet. Just 
like all other Piippetlime events, these "^move" events can be 
generated at nmtime based on user input devices (e,g. a joystick) 
or can be stored along with other evenLs in an event stream (e.g, 
panning during playback of a movie). At this time, there is only 
one c:amera puppet allowed; future versions of Puppet'rinie will 
expand ilie role and u,se of camera-enabled puppets. 

Creating your own puppets 

There are sevemi puppets with sample c'ode available in the 
SDK, which demonstrate die profier way to use the base puppet 
component. Use these example projects as the tiasis for yt^ur 
puppet development. 

Make sure dial you edit die ‘thng' resource, and choose 
mixed- or upper-case consianLs for the subtype and manufaclurer 
fields. At diis time, there are no flags defined for puppets, so Eero 
diem (juL for now. 

When implementing puppets, you’ll have to decide what 
vocabularies to support. Thei-e are several sets of vocabularies 
already defined in PuppetTime, such as core and music. The 
[>ase puppet handles a number of the core events for you. 

YouVe also free to create your own voeai:)uiarics, but you 
should use your manufacturer code as the message class; youH 
also liave to generate PuppetTime tracks using your vocabularies. 

Music Puppets 

For music puppets, the file PuppetTfmeMusicEvents,h 
contains all the constants for the music vcxabulary. The file 
PuppetTimeMusicEv8nts,c includes several utility routines to easily 
build music events. 

The PuppeiTime MIDI import component, discussed below, 
creates PuppelTime tracks using the music vocabulary. This 
allows a user to quickly generate Puppefl^ime cotitent by simply 
imponing MIDI files intc) QuickTime movies using applications 
like MoviePlayer, 

ClONmiCTOB 

Next we examine tlic heart of Pupfx.aTime, ihe conductor. It 
is the central object that binds the puppets to the drawing 
envirrinment and to the incoming event stream. 
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3D Environfncnl 

Wlicn an irLsiancc tjf ilie a>ndyctor component is created, it 
in turn iastantiaies a numlier of QuickDraw 3D objects to set up 
a drawing environment, including a renderer, viewer, coniext, etc. 

Each puppet Ls responsible for its (.>vvn gcamctries, yet this 
infonnalion needs to Ixf communicated to the conductor at some 
point. This is done when the conductor is instructed to draw: each 
puppet gets a chance to submit iLs geomelries (and oilier oltjects) 
to the Quic kDraw 30 rendering loop maintained by the conductor 

Event Dispatching 

Resides being responsible for the overall display, the 
conductor Ls also responsible for dispatching events from an 
incoming events stream to the puppet instances. 

Mhere is a class of events spc*cific to tlie conduaor, like the 
*cast' event. Events targeted to tlie conductor have a target ID of 
zero, A cast event has die structure shown in Figure 5 



Figure 5. A cusi eimii stmclure. 


The cast message contaias the following tielcLs: 

• kPuppetSubType: this field contains die sulitype of the 
puppet component to instantiate, or cast, Ihis field 
corresponds to the subtype field in the 'thng' rt*soijrt:e that 
defines your puppets. When casting a puppet, the conductor 
will search for a component where the type is 'Fl’pi' and the 
suhtytie is the value in this field, 

• kPupiX'tMaker: this optional field allows you to further 
identify your (ntppet component, which matches the 
manufacturer field in your ‘thng’ resiuirce. When casting your 
puppets, you should use this field to avoid name ctillisions, 
which can result in the wrong puppet being cast, 

• kl’uf^peiNaine: this field is also optional, bur if it's present, it 
will lx used in future version of FuppefUme for things like 
onscreen identifiration and event targeting via name. 

When die conductor receives ‘cast' events, it examines the 
contents of the event to determine which puppet to instantiate, 
then creates and stores a puppet in.stance in its internal array. 
Cast events are among the first events passed to a conductor. 
Without them, there would tx no puppets visible and nothing to 
dispatch further events to. You can use the routine 
PTAddCastingEvenlToUst to easily add a cast event to an event list. 
Note that a cast event doesn't tell the puppet where it should fx 


when it is created; therefore, you should also add a locate event to 
the event stream asing the routine PTAddLocateEventTaUst. 

WeT talk alxiut cast events as they pertain to QuickTime 
movies Ixlow. 

Current Camera 

The conductor has the concept of a current camera, which 
is itself a puppet. When a t'onducior first initializes, and after it 
has created the QuickDraw 3D drawling environment, it casts a 
camera pujipet and assigns it a special 11) kPTDefaultCamera. This 
gives the conductor an initial view in which to draw. 

Events can be targeted to tlie default camera by using an ID 
of kPTDefaultCamera Because the camera objea uses the base 
pup|iet, it understands many of the core vocabulary, like "move 
to"' and “uirn'*, 'fhe first version of EupficaTime supports only one 
camera, fiut future versions will expand on this, 

QoickI’imf intf,c;ration 

Ihe first part of iliis article described how Puppefrime is 
structured around QTAtoins and puppet components. Now leLs 
focus on how Puppetl'ime is integmied witfi QuickTime, The 
initial release of PuppeiTime allows for basic creation and 
playhac:k of QuickTime movies containing Puppefl'inie tracks, 

PuppefFime Tracks 

A PuppetTime track in a C^uicklhiie movie lias the type 
■PTmh’. Each sample in a Pup|>etTime track is a QTAtomContainer 
structure containing a list of PuppetTime events. The events in 
this list represents at minimum 2-3 seconds worth of aninijiiioii; 
the duration of each satiiple can be nuich larger, I'his a.ssures that 
disk access Ls minimizec;! for lietier playback performance. 

Playiog Puppefrime l*racks 

In QuickTime, each tniek tyjx has a corresponding media 
handler component which handles the playback of die track 
contents. So, a videtj track is managed by an instance of the 
video media handler, and a sound track is managed by an 
instance of die sound media handler. 

11te Puppet'finu* mt*di:i type^ is no differenl: a Pupjiefllme 
track Ls managed by die Pu|)[ietllme media handler, wliich is a 
dtmval media handler, Wlien QuickTime opens a movie and finds 
a Pu[i|>efrime track, it se;irches fiir the corresponding IhpixtTime 
media handler (by finding a tx>mponeni of tyjK- 'mhlr' and a subtype 
e<|ual lo ific track tyjx, in this aise 'Plmh') and cieates an iastance. 

Being a derived media handler, many of the functions are 
handled by the base media liandler component. The PuppetTime 
media handler dexs liandle certain routines itself, and the mast 
notable are Media Initialize and Media Idle, 

Medialnitialize function 

During movie initializalion. Quickfime calls the media 
handler routine Medialnitkilize, Here, the PuppetTime media 
handler aeates an instance of the PuppetTime conductor and 
tells it about the visual diiticnsions c:)f the track. 
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Next, it looks for some cast data associated widi llie track* Tfie 
cast data is stored separately so dial die c^st of the movie can lx.' 
easily cltanged. For example, in a FuppetTime track that contains 
music events, the actual puppets used during playirack can be 
changed by modifying the cast data. 'Ihe resulting vlsuuI 
representation will 1^ different while tlie underlying event stream 
remains valid. Use the routines PTGetCast and PTSetCasI lo get 
and set the cast data for die inack. 


aiiError “ PTAddNotfiEventTqLis t (aiiEvent List. 

I, // largin 

65, //lime 
60. // note 

0 * // vdoLift' 

0): // duratian (0=^(1^) 

aOesc “ CPTMHDescriptlcinEandlc) 

NewHaridleCUartsiEiJof tPl'ItHBestciption)); 
(‘ *aDesc) .size = si^.eCif {PTMIIOescription) j 
{*'sDescK type "" kPTWHdiaType: 

[*.version = kPTMediaVerslon: 


Medialdle function 

If the conductor is the heart of PuppeHmie, liien the 
Mediuldle function is the heartbeat of a FuppetTime track. This 
routine is re,sfK)nsible for reading in samples from the underlying 
media and passing them off to the conductor for dispatc:h. l\ also 
gives idle time to the conductor so that it am draw. 

Creating PuppcHIme Tracks 

Of course, playing a Fuppetlmie track is only aseftil if you 
liave a Puppefllnie track. Caraiing a ITippetTuiie track in a 
QuickTune movie is simple. As explained alxwe, each .sample is a 
list of events; in tliis way the sitmples aie spaced apart sucih that the 
disk isn't accessed too often. listing 8 shows the s;tmple description 
record, whit'h is rather imcomplic’ated. Listing 9 demoastrates tile 
concepts lx:hind adding a FuppetTime media lo a movie. 


// Stan editing sesskin 

anErcor BeginMediaEditHfthcMedia): 

// iidd ilic diiisi to the mt^dia 
anError = AddHp.d laSainple{theMedia, 

(Ikndle) anIventList, //the-sample 
CL, //tiffsti 

CetHandleSl7.fl [ (Handle) atiHventLlet). 
65, // dtiraLLon of sampk 

(Saropl nDejsc rip Liuidlatidle) aFesc, 

1. // number of 

0, //sample flags 

^samplerine): // nctumed rime 

// end editing sesskiii 

aiiBcror = EndKedlaEdits {thoMcdia); 


// append lo the lock 
anError = TnserfMcdialntoTrackt 
theTrack. 

- 1 . 

0, 

65, 

IL « I6}j 


// the track 
// where to insert 
// where m die tiK'dia 
// how much media to dUicfT 
// Uvt media rale 


Listing 8: FuppetTtine sample description 

typRdcf Struct PTHHDescriptlon 1 
1 orig size: // Total si/e of struct 

lung typa * // kPl'MediaTypc 

long resvdl: 
short tesvd2: 
short dataRcritidex; 
long version: 

I PWincscription, ^PTHHDesoript lonPir, 

* * PTKHHgsc rlpt i onHa n die; 


Listing 9: creating a PuppetHnie track 

Track myTrack; 

Media inyMedis: 

QTAtomConiainer anEventlJst; 

PTMHDeserlptionHandle aDeac till; 
TimeValue samplcTitna: 

myTrack NewHovleTrQek(LhGMovie, 

(tong) rayWidth << 16, 

(lung) rayHeight « Ifi, 

0 ): 


// create Ihc media ftir the track 
niyMedia ** NewTrackMcd la (myTrack, //the track 

kPTMed i a Type, // Uic type <jf media 

aTinioScale, //time fK:a]e 

nil, //data ref 

(OSTypo) nil): //tyi>c of data rcf 


anEventList = PTNawEventLlst0r 
anError PTAddLocateKvoiUToList(anEventList, 

1, // target 

0, //time 

0, //X 

0. //y 

0): /f^ 

anE r ror = PTAddHo teEve ntTol, I s i (a nEventLi s t, 


I, // target 

5, // lirtie 

60. //ikMc 

9b, // vdtHaiy 

0) I // duration (tteformr) 


Of course, there are routines in ihe FuppetTime toolbox that 
make creating FuppetTime tracks even easier, like 
PTAddPyppeflifneSampfe and PTSetEventLIslForTrack. 

PiippelTime movie Iniport cauiponcnt 

Users should have an easy way to create FuppetTime tracks 
from abundant existing conient. 'Ihe initial release of 
FuppetTime focuse^s on music vusualizaEion, and includes a 
movie imptiri component that converts M1I>1 files into 
Fuppefrime tracks. 

Quicklime already includes a movie impt>rt comjxjneni for 
MIDI files, llie trick Is to htx)k into the QuickTime import 
component such dial while it is creating a music trairk, Puppet llme 
gets a chance lo aetile a FuppetTime track alongside ll 

This can be done by capturing the MIDI import comjxinent 
and mt>laLing it widi the PuppetTime inifKiri component. Hhis is 
a step l>eyond just delegating to a component, Caplttring means 
(hat the Puppet Time import component gets exclusive use of the 
MIDI import component, and Lakes the latter out of die 
Comixxicnt Manger's airrent registry. 

Also, PuppetTime warns lo Qiptuie the MIDI import component 
at sLartup time, so that whenever QuickTime .starts to import a MIDI 
file, and fcgandlcss of wliidi application Is calling Quick'lime, the 
ITippetllme MIDI import cximponeni gets to do its magic. 

Capturing a component at nmtime takes a bit of finesse. 
First, the Ihog' resource must lie properly configured: the type 
and subtype of die PuppetTime import componenL must match 
the component being c^apluring (in this case 'eat ' and *Midt’), 
Next, the cmpWantsRegisterMessage flag is set to true, which tells 


January 1998 • In MacTech 


SiiprarjiNG Links in Youk OpenDoc Fari 


85 





the Componenl manager the Piippetl ime import component 
wants its Register routine called ai .startup. Tlie rest of the 
component flags should be the same as the component being 
capturing. Finally, the PuppelTime movie import component is a 
FPC native component, so the componentHasMultiplePtattorms flag 
is set to true. This tells the component manager to find tlie 
component in the extended ‘thng' structure. 

Now that die component successfully captures the MIDI 
import component, it needs to override the 
MovieExchangeImportRle function. This routine calls through lo the 
captured and delegated MIDI import component, which proceeds 
to cTeate die music track from the MIDI file. After that routine 
returns, the PuppetTime import compoiient then re-reads the MID! 
file and creates a PuppetTime track, converting MIDI data 
structures into Puppet'Ume events using die music vocabiihry. 'llie 
code could have just as easily read the newly created music track. 
Eitlier way, without any extra effort on the user's part, a new movie 
is created that contains botli a music track and a PuppetTime track. 
To make the user experience ct jmplcte, the Puppefl’ime import 
component also overrides tlie MovieExchangeDoUserDialog rtiutine. 
In this case, however, it doesn't call through to the MIDI im[X>rt 
component, but puts up its own Options dialog instead. 

Sample Code 

in the IhippeiTtnie Sample Code IVe included slightly alieiecl 
versions of tiie PuppetTime media handler and die Puppeffime 
movie import component for yr>ur review. You’ll note thai IVe 
changed all occurrences of die subtype and manufacturer fields to 
^XXXX' and ‘YYYY. If ytju choose to use these samples for the \nsis 
of your own projects, please change the constants to something 
more suitable. Also, please don't re-use my constants for the 
various Puppefl'ime components, particularly “PTmh’ for my media 
handler and media type; tliis will allow me to continue developing 
PuppetTime witliout external complicaiiorLS. 

FuilfRli DiRECnON 

Much like the QuickTime architecUire, PuppelTime is 
designed with future growth sc|uarely in mind. 

More QuickTime integration 

Wiih the initial release of the PuppetTime engine, only two 
QuickTime-related componenls are included: a media handler 
and a movie ijnport comjxment. As PuppetTime continues to 
develop and mature, more Quickfime components will l?e added, 

• Sequence grabber channel: A Puppet'Ume .sequence gnd>lx.T 
channel will work with the sequence grabber ct>mponent to 
capture PuppetTime tracks in real-titne from a numlx^r of 
input devices, like keylx>ards and joysticks. It could alscj lx.* 
used to capture a network event stream, stjch as in a mufti- 
user game environment. 

• Movie Controller: Puppen’ime is well integrated with other 
Quick'l’ime media types, but the existing user experience 
doesn't allow the aser/viewer to move aroimd and among tlie 
puppets currently being displayed. A PupfietTime movie 


controller will add a trackpad' like control alongside the 
other Quickl’ime movie controller controls that allows the 
user to move the camera puppet while the movie is playing, 

• Movie Info Panel: Not necessarily a formal yxiit of tlte Quick'Tlme 
framework, a PuppetTime movie info panel will allow asers to 
change the puppeLs in die c'ast for a PuppetTime track. 

Cross^platform 

Of course, creating a new media type, especially for web 
ami internet appliauions, isn’t as compelling unless it works on 
Mac and Windows. Near-term future development will fixus on 
bringing the core tcK>lh<>x and component funciionality lo both 
plafforms under QuickTime 3.0. 

Consumer Applications 

And, of couRve, the PuppetT'ime architecture exists so that 
developers can create applications that create and edit the 
PuppelTime media type, A couple of consumer-level 
applications that Td like lu see happen are the Puppet Builder 
and the Puppet Scene Maker. 

The Puppet Builder applicaiion would allow a user to create 
new puppets, giving them shapes and simple animations, and 
matching animations io cvenLs. 

The Puppet Scene Maker would allow' a user to create a 
scene with dialog in 3D, Drag puppets from a cast window onto 
a stage window, then enter diakjg in the script window. Drag 
actions from a vocabulary window onto the script window to add 
movement, nuances, etc. 
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URLs 

The QuickT ime homepage is at <http://quicktime.apple.com/> 
and the QuickTime developer homepage is at 
<http://quicktimE.apple.com/dev/>. 

TTie PyppetT mie homepage is at <http://www.puppettime,corn/>, 
where you can downkrad die latest d<x:s, mniime, and SDK. 
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CodeWarrior for 
PaImPilot 

by Metrowerks 
CodeWarrior for PaImPilot is 
the first complete set of tools 
which enables you to develop 
for the U.S. Robotics PaImPilot 
connected organizer, from the 
comfort of your PC or 
Macintosh computer. All the tools you need are included: the 
award-winning CodeWarrior IDE, compiler, linker, source-level 
debugger, GUI builder, and other tools, plus online 
dxumentation and reference materials. Includes one free 
product update and free technical support with registration. 
(SCWPALM) Our Price $369 
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CodeWarrior 
Latitude 

by Metrowerks 
Don't throw away the 
investment you have made 
in your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. At the 

heart of Latitude is a set of shared libraries which performs the 
functions of the Macintosh API. You recompile your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application. As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive all developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 

(SCWLAT) Our Price $399 
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CodeWarrior 
for BeOS 3 

by Metrowerks 



• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete dxumentation, useful 
C-r-r classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program tor 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 



MW Visual 
SourceSafe 
Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
CodeWarrior IDE or 
stand-alone Client application 

• Compatible with Microsoft Visual SourceSafe version 5.0 

• Cross-platform support (Mac, Windows, UNIX) 

• Configuration management In excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users rxeive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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CodeWairior 

Discover 

Programming 

Edition 

by Metrowerks 



• Leam to program in C/C++/Java/Pascal 

• Full-featured programming product-not a “life" edition 

• Online books and tutorials 

• Hosted on either Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price. Whether you 
want to learn the basics of programming or add a new language 
to your skill set, Discover Programming puts the information and 
tools you need at your fingertips: the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
(with your registration). Discover what you can learn vrith 
CodeWarrior, buy your copy today! 

(SDPED) Our Price $79 


BeOS Preview 
Release 2 

by Be, Inc. 

/ts the Internet spreads and 
electronic media becomes more 
prevalent, the high-performance 
needs of digital content design and 
the complex, aging architectures ot 
current mainstream operating 
systems are coming into cortfiict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today. 

(SBEOS) Our Price i49 

Macintosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 

• Power PC native environment & compiler, full Macintosh support 
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CodeWarrior 
Professional Release 2 

by Metrowerks 


• Includes Windows 95/NT and Mac OS versions of the 
CodeWarrior IDE 

• Supports C, C-I-+, Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 
68K/PowerPC 

• Project Manager supports multiple open projects, subprojects, 
multiple targets per project, and threaded execution 

• Support for JDK 1.1.3 in CodeWarrior Java 

More platforms, more languages, more options: CodeWarrior 
Professional is designed to give you the tools you need for 
serious, industrial-strength programming. CodeWarrior 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C, C+-(-, Java 
and Pascal programs for multiple target processors and 
operating systems. CodeWamor’s compilers produce fast, highly 
optimized code for Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors. CodeWarrior 
Professional features the CodeWarrior IDE Version 2. The 
revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded 
execution, and it's significantly faster. CodeWarrior Professional 
also includes online books, documentation, and reference 
materials, as well as tutorials and sample code. We support 
your development efforts with one tree update and free world- 
class technical support for a year with registration. 

(SCWPRO) Our Price $449 
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800-MACDEV-1 
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• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 
■ Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools. 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 
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MkLinux: Microkernel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 
MkLinux is a native port of Macti 3 and 
the Linux 2.0 kerne!, complemented by hundreds of commands 
from BSD, GNU, and X11. It runs on most (NuBus and PCI bus) 
Power Macintosh systems; Performa, PowerBook, and 
multiprocessor ports are currency under development. 

MkLinux is robust, powerful, freely dishibutable. and source code 
compatible with most other Linux systems. It provides a full suite 
of development tools, support for AppleTalk, HFS, and Objective- 
C, and access to a vast amount of free software. MkLinux is a 
great way to “come up to speed" on Mach. UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach, NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
(BMKUNUX) Our Price $49 
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VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications In standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks' CodeWarhor 
(SVIPB/SIC) Our Price $195 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create lull-featured, stand¬ 
alone Macintosh and Power Macintosh applications In just minutes. 
VIP-C 2.0 is the first rapid application development system tor 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code: automatically integrate C code with a cunent project 

• Includes full-featured mini database: (ltd to 32Kj of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-tree, multi-user database applications 

(SVIPC) Our Price $295 




Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90. VAX compatible F77, and 
C/C-n- compilers into a single, easy to use environment. Ail compilere 
are link compatible and ofrerate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data sbuctures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C-f-F, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox. MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 


SmalltalkAgents for Macintosh 

by Quasar Knowledge Systems, Inc. 

• An Integrated Develctoment Environment (IDE) based on QKS 
Smalltalk. 

• "Live” direct manipulation of your objects 

• Dynamic, interactive and iterative development process 

• Easy and full acce^ to the features of the Mac OS(tm) and Mac 
Toolbox 

• Link your non-Smalltalk code fragments with Code Fragment 
Manager (CFM) support 

• Cross-reference, access, view, and manipulate your code and 
objects with a sophisticated database for source code 
management 

• Includes an Application Delivery Toolkit(tm) (ADT) that allovw you 
to create royalty-tree, standalone, double-clickable applications 
(SSTA) Our Price $395 
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ObjectMaster 
Professional Edition 

by Altura Software, Inc. 


Object Master is an innovative programming environment ttiat 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 


Roaster 

by Roaster Technologies, Inc. 

Get the most out of Sun's Java™ 

programming language vwth this 

powerful development environment. 

• Features include: ability to build 
stand-alone Macintosh applications 
Of applets; visual interface builder; 
ability to create cross-platform zip 
files; powerful Java debugger; wizard tor quicWy creating Java 
applets or applications; JDBC iricluded; Java object database 
included; ability to call AppleScripts from Java; Just-ln-time (JIT) 
compiler; JDK 1.0.2 support (JDK 1.1 support witti a free web-based 
update); class tree and hierarchical class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE for 
Java; OpenUnk Software's JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web-based updates. Release 3 owners now have 
access a web-based update to Release 3.1 with JDK 1.1 support. 
(SR0AST3) Our Price $99 

Also see Internet Related, page 13 



NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 



A fully interactive implementation 
of BASIC programming language 
Runs entirely on the Newton - no 
host is required 

Create files, access the built in soups, and the serial port for 
Input and output 

Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from WWW, nsbasic.com 

Release Notes with sample code are available frtm the same location 
Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 that 
have full memory available 

Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



''TENON 

INTERSVSTEMS 


CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-n-, 
Objective-C, Java, Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C+-I-, Ada 95 and Fortran 77 

• Web & internet scripting tools: Pwl, MacPeri, tcl/0<, bash, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 



j Here’s a list of all available products. For full product descriptions 
‘ please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

Think Pascal 4.0 

SPASCAL 

165.00 
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PowerKey Pro Model 200 

by Sophisticated Circuits 
PowerKey Pro Model 200 lets you start 
up and shut down your Mac and up to 
five peripherals with a 
single keystroke. Two 
groups of switched 
outlets let you control 
some peripherals 
separately. PowerKey 
also features phone 
ring startup which 
lets you access your 
Mac while on 
the road. 

Powerful scheduling 
features let you 
control your outlets with "hot keys” or 
perform tasks unattended. Start up your 
computer at any time of the day or night, 
open applications and run AppleScripts 
or QuicKeys, Add the opfionat Server 
Restart Option and you can even restart 
crashed servers automatically! 

System Requirements; Mac with ADB 
port, System 7 or later. Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99 


PowerKey Pro Model 600 

by Sophisticated Circuits 
PowerKey Pro Model 600 is “the worid’s 
smartest power strip!" Start up and shut 
down your Mac and 
peripherals with a single 
keystroke. Includes six 
individually-switched 
outlets, with manual 
switches arrd indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys’’ or perfomi 
tasks unattended. Start 
up your computer at any 
time of the day w night, 
open applications and tun AppleScripts or 
QuicKeys. Complete telephone controltabllity 
lets you start up the computer, switch outlets 
a run complex events using custom touch- 
tone commands. For a limited time. Model 
600 includes the Server Restart Option. 
Restart crashed servers automatically! 

System Requirements: Mac with ADB port. 
System 7 or later. Telephone features 
require analog phone line. 

(HPKEY6) 0urPrice$199 




ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C+-I- classes for integrating Inter 
e-mail in your applications 

■ Helps you write software that can share m 
with other leading e-mail products 

• Royalty-free MIME. SMTP, and POPS APIs 
Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser ai 
enctxler available 

• Ideal for use in Internet and Intranet 
environments 

• Comes complete with samples with 
documented, reusable source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



NetMinder Ethernet 

by Neon Software 

NetMinder Ethernet Is a softvrare-only 
protocol analyzer which captures and 
decodes a full range of Ethernet 
protocols including IP, AppleTalk. 
NetWare. NeBIOS and DECnet 
Features include; 

• Sophisticated long-term monitoring 
with HTML output 

• Intuitive and powerful filtering 
capabilities 

• Automatic me^ping of names to 
Ethernet. AppleTalk, and IP Addresses 

• Rules-based engine for detecting 
unusual network conditions 

• Customizable graphs tor bandwidth 
utilization and packet rates 
(SNETMD) Our Price $715 


Memory Mine 

by Adianta, Inc. 



• Monitor heaps, identify problems such as 
memory leaks, and stress test applications 

• Active status of memory in a heap is 
sampled on the fly; allocation in non- 
relocatable (Ptr), relocatable (Handle) and 
free space is shown, as are heap corruption, 
fragmentation, and more 

• Allocate, Purge, Compact, and Zap memory 
lets users stress test all or part of a program 
(SMEMMINE) Our Price $99 


Future BASIC II 

by Staz Software 

FutureBASIC II is the award winning leader in Macintosh BASIC 
programming. 

• Source level debugger and Interacttve compiler/editor 

• Multi-file Project manager and Multi-flie find and replace 

• Super fast compilation. 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example tiles 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 
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Vfv f / Visual MacStandardBasic 3.0 

- ^ ^ j^DOCT! ZCurve Software 

"■’*** Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, Icons, pictures 
and timers can be created and modified instantly 

• Use color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting oider BASIC 
source code from other platforms 

• Online tutorial, manuals, sample projects get you pfogramniing quickly 
(SVMACSB) Our Price $99 
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Spotlight 

by Onyx Technology, Ina 

Spotlight is a stand alone 
debugging aid that performs memory 
protection (arrays, heap accesses, outside 
your heap, low mem, etc), discipline checking 
on tooltMx calls, and leaks detection, 

• Spotlight is sold on an annual subscription 
basis 

• The subsaiption service provides all updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal date. 
(SSPTLT) Our Price $199 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
xero, de-reterence zero as well as other tests like tree 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 


QC 
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MacA&D 


MacA&D 6.0 

by Excel Software 

• Structured analysis 
and design 

• Object-ofienied 
analysis and design 

• Real-time and multi¬ 
task design 


• Data and screen modeling 

■ Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams tor C, C++,etc. 

• Design diagrams to code for C, C-H-, etc. 

■ State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) Our Price $1995 




Apprentice 6 

by Celestin Company 
Apprentice 6 is a high-quality CD-ROM 
collection of over 600 megabytes of up-to- 
date source code, utilities, and info for Mac 
programmers. All of tfie source code and 
utilities are completely new or updated for 
this release. 

• Frontier 4.1, the highly-acclaimed 
scripting environment 

• More PowerPlant AND many more 
PowerPC samples 

• Cool new languages and environments 
added (Clean, Eiffel, F, Tcl-Tk) 

• Hot new demos from leading Mac 
development companies 
(SAPPRENT6) Our Price $35 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional 
replacement for the List 
Manager used by developers worldwide. 
Version 3.0 is a new release with many 
improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWairior C & 
Pascal 

• Includes libraries for 68K (A4 & A5) and 
PowerPC 

• An LTable-like class is provided to 
incorporate StoneTable into the 
PowerPlant environment 
(SSTONEFAT) Our Price $199 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for all 
sorts ot projects (software 
development, documentation, design, 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management of variants 
and revisions of entire projects (not wily 
of single files) 

» Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text tiles!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

files) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking {Finder flag 
or 'ckid' resource) 

“ Scrlptable, essential parts PowerPC native 
Single license (SV00D001) $229 
2 pack (SV00D002) $359 
5 pack {SV00D005) $799 
10pack(SV00D0Ol0) $1369 
20 pack (SV00D0020) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 
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Be Basics 

by BeatWare 

Be Basics is the first productivity suite to 
combine the essential tools you use 
everyday with the incredible power of the 
BeOS. Be Basics 

offers the BeOS developer the ability to; 

• Combine text, tables, graphs and pictures to create compelling 
documents 

• Work with multiple files simutlanecxjsly writhout degrading performance 

• View all laymit, style and content changes as they happen 

• Import Microsoft Excel files 

• Plug-in third party graphs and filters 

Be Basics requires the BeOS. 16 MB of RAM, 2 MB available hard 
disk space and a 256-color display adapter. 

Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBEBAStC) Our Price $69 


CodeBuilder "TENON 

by Tenon Intersystems intebsystsms 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new, 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C++, 
Objecfive-C, Java. Ada. and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C. C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Per), MacPerl, tcl/tk, bash, sh, 
andc^ 

• Supports Rhapsody kernel /V’Is and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 


Guide Composer'" 1.2 

by StepUp Software 


STEP"” 

SOFTWARE 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same fonnat as the user 
will use them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases. Coach marks, Fully-Integrated with Apple's 
Guide Maker (distributed with Guide Composer), compiles scripts 
automatically, PICTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www.guideworks.com/ 

(SGCOMP) Our Price $99 


SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 


B-lk'ee HELPER 2.2 

by Magreeabte Software 

• Inexpensive database engine 
tor Macintosh programmer 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds liste of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 




BBEdH 4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
leam text and HTML editor that 
offers developers and HTML 
authors the abili^ to build on its 
core functionality to suite their 
specific needs through Its plug-in architecture and scripting 
capabilites. This new version includes: a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage for 'grep' patterns, scriptable HTML 
authoring preferences arHf more. It still provides: unparalleled 
searching muscle with support for botti 'grep' style and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders. Integrated support for Symantec's 
IDE. Metrowerks CodeWanior, THINK Reference 2.x, MPW 
Toolserver and most other environments and a heck of a lot more. 


(SBBEDI7) 0urPrice$119 
Also see Internet Related, page 12 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScrIptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
loiowledge of Rez 

• Supports StepUp's InstallerPack, Stutfit decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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BeSpecific 3 


^dUCT! 



(Third in a series) ' 

by Adamation " 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming tools • Grapliics Games 

• Commercial demos 

Newsgroup archives (comp.sys.be) Developer mailing list (Be DevTalk) 
BeSpecific 3 is brimming with useful BeOS Preview Release-compatible 
software. A “must have" companion for ail users of the BeOS. 
(SBESPEC) Our Price $39 


Pilot Attache 



Pilot Attache Disk 1 . 

(First in a regular series) > 

by Adamation 

The Pilot Attache CDROM, designed for'the 
popular US Robotics Palm Pilot organiser 
provides you the best in Pilot shareware. 

Extend your Pilot's capabilities across a 
wide range of application areas, including: 

• Personal productivity toots • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache’s shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don’t forget your Attache. Pilot Attache...your passport to success. 
(SPATCHE) Our Price $29 


Waters Edge Software 



Tools Plus libraries + 
framework 

by Water’s Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a single routine, and it 
transparently provides a robust infrastructure to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUI elements 

• Ttiousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 3D grayscale options 


• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs wodd-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 
CodeWarrior Gold 
(C/C-H-& Pascal, 68K& PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C-t-n & Pascal, 68K) 

(STOOLSYMT) Our Price $199 
Symantec (THINK) C/C-n- and THINK 
Pascal (68K) 

(STOOLSYM) Our Price $149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

‘CodeWarrior required to write plug-ins 



AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder 

• Just point fflid click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C-++, or Pascal; 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 


• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy documentation 
(SAPPMAKE) Our Price $199 




Testlh^ck-Bug Ifacking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurabons, users, and more 

• Includes notifications, purity, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure ait bugs 
are identified, fixed, and dxumented 

• Eliminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) Our Price $129 
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SuperAnalyst 

by SuperSoft 

SuperAnalyst is an 
easy-to-use data 
analysis and plotting 
application written 
specifically for the 
Apple Macintosh 
computer and 
PowerPC. It provides a 
wide range of X-Y plotting and analysis capabilities at a click of the 
mouse. It is easy to use and provides interactive control of the 
appearance of almost every characteristic of your plot. You can 
overlay multiple plots on the same graph, and the number of 
points is limited only by the memory of you computer. 

• 16 Plot Types; Scatter (Box and Cross), Line (with and without 
symbols). Function, Log-Log. Semi-Log, Double Y. Bars. 

Columns, Stacked Bars, Stacked Columns, Area, Pie, Polar, and 
Histogram. 

• Function Plots: Plot mathematical equations you can input 
without constant reference to the manual. 24 intrinsic functions 
(cos, sinh, exp. In, sqrt, erf, bes, gam, etc.). 

• PLIK, set templates, reads many file formats, smooth, filter, and 
sort data, modify data, error bars, function and data integration, 
FFT tranforms, curve fits, etc. 

(SSANAL) Our Price $99 



QUED/M 3.0 

by Nisus Software 

• The programmer’s text editor that defined the 
industry staidard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C+-h, Metroweri<s CodeWarrior 6, and MPW 

■ Supports all the major development environments on ffie Macintosh. 
Powerful editing features, including unlimited undo and redo, macro 
language, schpting, text folding, ten editable/appendable clipbo^ds, 
nwkers, displaying text as ASCII codes, dynamic coloring of C/C+-(- 
keywords/comments, rectangular and non-contiguous selection 
Includes Celestin Company’s APPREMfICE 4 
(SQUEDM) Our Price 1^9 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividers, and sample HTML pages. 
There are literally thousands of graphical elements on this disc, all there 
to spice up your web page. In all, it's about 300 megabytes of creativity 
only a mouse-click away! System Requirements: PC - 486 or better with 
8 MB RAM, Sound card, SuperVGA, CD-ROM drive. Macintosh - Color 
Mac with 8 MB RAM. CD-ROM drive. 




(SWEBW) Our Price $24 
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SuperPlot ‘ 

by SuperSoft | 

SuperPlot is a plotting library which can 
be linked and called directly from ^ 

programs written in either Eortran. 

Pascal, or C. SuperPlot provides a simple 

way to plot data generated by your program, edit the plot, and then 

print, export, and/or save the plot for future reference. 

A simple subroutine or procedure cal) hides your applications menu 
bar, puts up SuperPlot's menu bar, creates a new window, and plots 
your data. It provides you with complete control of the appearance of 
your plot using the mouse, menus, floating palettes and dialogs. 
Preparing presentation quality graphs of your data was never easier. 
SuperPlot runs on either the PowerPC or 68 K computers. 


(SSPLOT) Our Price $195 


SuperPlotPRO 

by SuperSoft 

• Plotting data from your program was never easier 

• A Plotting and Chart Library callable from Fortran, Pascal, and C 

• Plot Types: Scatter, log-log, x semi-log, y semi-log, Ddouble Y, 
cross, line, line w/ symbols, bar, stacked bar, column, stacked 
column, area. pie. polar 

(SSPLOTPRO) Our Price $295 



AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to A6 Author: 

• Support for styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: A()pleGuide Conplete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 


SoftPolish CD-ROM 

by Bare Bones Software 

• The essential tool for soflware quality 
assurance on the Macintosh 

• Helps you Identify inconsistencies with 
Apple's user interface guidelines, 
misspelled words, missing resources, 
and other mistakes 

■ Provides tools to put the finishing touches on software distribution 
packages prior to release 

■ Works independently of any programming language or environmertt 

• Ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 
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VText 

by Vivistar 

VText is a C++ add-on library for 
Metrowerks’ PowerPlant applicatiorr 
framework. VText provides complete 
Macintosh texl support including: greater 
than 32kb text, undo, drag and drop editing, 
AppieEvent scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and ruiersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript savvy including bidirectional and muttibyte scripts with 
inline editing 

• AppieEvent factored for scriptabiiity and recordability 
(SVTEXT) Our Price $349 


OpenGL for 

the Macintosh f^JponLlL. 

by Conix Graphics 

OpenGL Is the premier 30 graphics library that allows software 
developers the ability to develop high-quality, interactive 20 and 30 
graphics applications. OpenGL can perform ttie following wide range of 
functions which will enhance the development of all graphics software: 

• Geomebic primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-unifomi rational B-splines) 

• Eeedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations [storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 



Bee-one 

C-tree Plus® Database Handler 
Compileltf 

CONIX PowerTools-10 Pack 
CPU Doubler 
DesignWorlts 4.0 
dtp 

EtherPe(^ 

Fortran 77 SDK 
ICONtX PowerTools-6 Pack 
ICONfX PowerTools 0 Pack 
ICONIX PowerTools-AdaPlow 
ICONIX PowerTools-ASCII Bridge 
ICONIX PowerToolS'CoCd^o 
ICONIX PowerTools-DalaModeler 
ICONIX PowerTools-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerToolS-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat Library 
Info-Mac X 

Ionizer Real-Time Spectra* Reshaping Tool 
UveAccess^'^ t User Edition 
LiveAccess^^ I Developer Edition 
LiveCard 
LJ Profiler 

MacFlow": Flowchart Design and Development 
Mac Source II 
Nisus Writer 5.0 

Plan S Track^*^: Project Planning and Management 

Phyla™: Object Oriented Database 

r-tree Report Generator 

Spellswell Plus 2.1 

Spyer 

Visual Caf6 


CODE 

OUR PRICE 

SBEEONE 

$139.00 

SCTPDH 

$895.00 

SCOMPIT 

$149.00 

SICPP10 

$7,845.00 

SCPU2X 

$79.00 

SDWORKS 

$995.00 

SDTF 

$695.00 

SEPEEK 

$745.00 

SF77 

$699.00 

SICPP6 

$5,945.00 

SICPP8 

$6,945.00 

SICADA 

$1,395.00 

SICASCll 

$1,395.00 

SICCOCO 

$1,395.00 

SICDATAMOD 

$1,395.00 

SICFASTTASK 

$1,395.00 

SICFREEFI 

$1,395.00 

SICOBJMOD 

$1,395.00 

SICPOWER 

$1,395.00 

SICQUICKCH 

$1,395.00 

SICSMART 

$1,395.00 

HCONIX 

$2,945.00 

SIMSLSTAT 

$495.00 

SINF0MAC10 

$39.00 

SlONtZER 

$800.00 

SLAUE 

$69.00 

SLADE 

$99.00 

SLCARD 

$149.00 

SLJPROF 

$295.00 

SMACFl.O 

$179.00 

SMACSOURCF 

$29.95 

SNtSUSW 

$220.00 

SPLNTRK 

$179.00 

SPHYLA 

$179.00 

SRTRG 

$445.00 

SSPELL 

$49.00 

SSPY 

$39.00 

SVCAFEMAC 

$199.00 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 



Web Site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen's 
Web-based browser 
intedace enabies iocal 
or remote administration via your favorite browser. Since Apple's MeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine" 
technology to produce a set of "Rhapsody-Ready" internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 coorrecbons a minute, or over 10 million 
connections a day 

• Apache runs in Tenon's multi-threaded, pre-emptive 
multitasking environment 

■ Tenon’s unique technology supports the widely acclaimed Apache 
Web server as a double-clickable Macintosh application 
(SWEBTEN) Our Price $495 




BBEilit4.5 

by Bare Bones Software 
(SBBEDrf) 0urPrice$119 

Also see Tools, Libraries and 
Utilities, page 8 


PageCliarraer: Sizzling Kffects... 



PageChamier 1.0 

by Mainstay 

PageCharmer is a set o1 customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

EEATURES; 

UveG-Map, LiveT-Map, LiveG Button, LiveT-Button, UveGT-Button, 
LiveG-Tfcker, LiveT-Ticker, UveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $99 


ObjectSet Mail SBK 

by Smartcode Software 

• Powerful C-n- classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use In internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



webAlias 1.0 

by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content tor multimedia and web 
design projects. webAlias integrates support for line, shape, tree 
fonn, field and button objects. webAlias' anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) 0urPrice$129 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring tool and 
on-line documentation 
system for the Macintosh and 
World Wide Web. HyperGuide 
provides integrated 
searching, indexing and 
bookmarking features. 

Supported media elements 
include; rectangle and 
scrolling fields, lines and shape fills, most QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies. 
HyperGuide also includes an integrated screen capture utility and 
user-configurable slide show mode. 

(SHYPGUD) Our Price $149 
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Roaster 

by Roaster Technologies, Inc. 

(SR0AST3) Our Price $99 

Also see Development 
Environments, page 5 



Rumpus 

by Maxum Development 

Maxum’s new, high- 
performance FTP server for 
the MacOS, Based on 
Maxum’s RushHour TCP/IP implementatiofi, Rumpus 1.0.1 offers 
the performance and retiability of high-end workstations with the 
ease of use, security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 



Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FTP, MFS. 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C, C++, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

■ Run Software.com Inc’s acclaimed Post.Office mail tr^sport service 
(SM10PPC) Our Price $695 


CGi Toolkit 

by Pictorius, Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site, 

•Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

(SCGITLKTl Our Price $149 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE 


OUR PRICE 


OOFILE Reporter Writer SOORW $499.00 

ScriptDemon SSDEMON $949.00 

WebSiphOri SWSIPHON $495.00 
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WindowScript 

by Royal Software, Inc. 



WindowScript is ttie ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh” user- 
interface right inside HyperCard. Unbl now you either created 
HyperCard stacks or Macintosh appiications. Widi WindowScript 
you can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping toot. WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Software Scripting Additions - a coilection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 

$129 


Scripter 2.0 

by Main Event Software 
For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice. Scripter! 

• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing. Object map, associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 



9 Script D^xjgger 



TCP/IP Scripting Addition 

by Mango Tree Software 
•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP™ commands in AppleScript™ 
•Send e-mail or files through a script, 
check if users are logged on (via Finger), automate FTP, Gopher. 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/tP client-server programs 
• Works with AppleScript. MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 

FaceSpan 2.1 SRT 

by Digital Technology International 
Single-user version ot the popular, cutting 
edge interface design tool which gives 
you the power to build and customize 
Macintosh applications quickly and easily. 

Used in conjura:tion with AppleScript or any other OSA language. 
(SFACESRT) Our Price $99 




TCP/IP 

Scripting Addition' 

Jht itnfnrrMrl 





FaceSpan v2.1 

by Digital Technology International 

•Develop Integrated software, make stand 
alone applications, create friendly 
interfaces 

•Develop quick prototypes, print multiple 
pages with sophisticated layouts 

•Script essential elements of the FaceSpan 


• Play and record sounds as either “snd” resources or as "AIFF" files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for implementing timed behaviors 
— New properties 

• Proportionally scale PICT images -Align Images in a picitjox - 
Automate any application 

• Monitor and respond to low-memory situations-Increased support 
for Fronber UserTalk! 

(SFACESPAN) Our Price $299 

DynaMorph 1.5 

by Morph 

DynaMorph is the only cross-platform, server-side scripting language. 
Easily build and maintain dynamic websites and web-based 
applications. Access external databases, separate the format of a 
website from its content, conduct e-commerce transactions and 
more. DynaMorph makes sites and applications completely portable. 
(SDYNA) Our Price $399 ' 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PreFab Player SPUWER $95.00 
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ClipVR"' 

by eVox Productions 

Clip VR" is a new digital image library offering high quality 
Photographic Virtual Reality (PVR) images for use with Quicktime* VR 
and other desktop VR tools. 

Clip VR' Panoramic Image components include alpha channel masks. 
Combine elements into a composite panorama which is converted to 
the finished QuickTime VR movie using Make QTVR Panorama Tod. The 
Components ("Clips") include complete 360 degree scenes, libraries 
of 360 degree terrains, 360 degree skies, buildings, and objects. 
Images are provided as .PICT files AND QuickTime VR movie files. 

Clip VR™ allows you to create high quality VR worfds from pre¬ 
photographed component images. Clip VR™ can be used to add 
excitement to a web site, to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging editing program such as 
Adobe Photoshop" to perform .PICT image compositing. 

(SCLIPVR) Our Price $89 


Screen Machine 

by BeachWare, Ina 

Personalize your computer screen 
wifii this dynamic and useful 
collection of Screensavers and 
Wallpapers. Choose from over 
100 original Screensavers such 
as flying airplanes, bouncing 
coffee cups, falling climbing gear, 
shifting psychedelic patterns, or 
floating spaceships. Customize your computer desktop with over 
150 exciting new wallpapers such as sand, rocks, cloth, coins, 
cartoons, or unique patterns. Included is an easy to use browser 
program that lets you sample all of the Screensavers and 
Wallpapers before installing them on your computer. 

(SSM) Our Price $24.95 


SCREEN 

MACHINE 



AudiollRck 

by WAVES 

AudioTrack is a software plug-in for native 
ki^ I processing on digital audio recording and 
1 tr editing systems. Waves AudioTrack combines 

the most-needed audio processors into a 
single piece of software, including 4 bands of equalization, 
compression/expansion, and noise gating. AudioTrack is ideal for 
preparing audio for InterNet streaming formats, processing individual 
mono/stereo tracks of audio and audio for video editing systems 
Including digital sequencers. 

Feature list 

• A single window interface 

• 4-band ParaGraphic Equalizer. Compressor/Expander and Gate 

• Instantaneous A/B comparisons of on-line settings 

• Pretested setup libraries supplied for various processing solutions 

• Power Macintosh native processing (requiring no DSP board) 

• Volume and gain reductimi meters 

• Peak hold and clip meters 


Requirements: 

The AudioTrack is compatible with all machines supported by Deck It, 
SoundEdit 16, Adobe Premiere 4.0 and Cubase VST 3.1 
(SAUDIOTRK) Our Price $270 


Captivate 4.6: 

Essential Graphics Utilities 

by Mainstay 

Captivate™ 4.6 is a powerful collecfion of 
graphics utilities for Macintosh, based on 
Mainstay's acclaimed screen capture utility, 
graphics and multimedia scrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike. 

• Pa(f<age includes: Captivate Select, Captivate View, and Captivate Store 

• Any one of the three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad, or just creating 
a startup screen from your favorite picture, Caplivafe is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) Our Price $79 
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Media Cleaner Pro 

by Teiran Interactive 
Use Media Cleaner Pro 2,0 to optimize and 
compress video for CD-ROM, kiosk, or [he 
Internet. Media Cleaner Pro automates your 
work flow allowing you to get the highest 
quality video, faster and easier than any 
other program on the market. 

• Includes Adobe Premiere Export module 


• Optimal palette generation, Drag-and-drop 
batch processing 

• RealMedia, VDOUve and improved 
QuickTime support 

• Dynamic Preview Window, the Media 
Wizard, multiprocessor support and more! 

System Requirements: 

68040 Mac or better (PowerPC strongly 
recommended, req'd for RealMedia), 


QuickTime 2.0 or later (2.5 strongly 
recommended) 

8 Mb application RAM, MacOS 7.0.1 (7.5 or 
later recommended) 

SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 
Registered owners of Movie Cleaner Pro 1.3 
or earlier can upgrade 
(SMCPUP) Our Price $129 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Digital Imaging Technology 



Magellan QC 

by Kaidan 

Tbe Magellan QC is capable of 
handling objects as large as six 
inches in diameter and five 
pounds in weight, the Magellan 
QC is the perfect choice for 
those needing to capture 
small objects at a 
reasonable price. Real- 
world objects can be 
turned into 3-D virtual 
reality movies using the 
QuickTime VR Authoring 
Studio and the Magellan QC. 

The Magellan QC leverages the capabilities of 
the Connectix'“ Color QiiickCam" digital camera for QTVR object 
capture. The Color QuickCam's close focusing capability (one inch 
to infinity), 640 x 480 resolution, serial interface (no video card 
required), 24-bit color support, convenient size and low cost make it 
an ideal camera tor many simple QTVR object movies. Using the 
Magellan QC is easy. Simply locate the object on top of the 
adjustable pedestal, perhaps with a small piece of double-sticky 
tape, and then adjust the arms and pedestal so that the center of 
the object is centered in line with the camera and the rotation axis 
of the swingarm. 


(HMAGQC) Our Price $299 


Magellan Accessories 


Magellan QC Pedestal Set 

Two extra pedestal tube assemblies, one 2.5“ and another 6“ 
long. These extra pedestal tubes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPED) Our Price $39 

Magellan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg), 12 (30 deg), 14 (25.7 deg), 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10, 
15,20,24 and 36 positions. 

(HMDWHLS) Our Price $74 



The QuickPan Magnum Series consists of two models, the QPX- 
1 and QPX-2. Featured on both models is the new QPU-2 
camera bracket. Based on the highly successful KiWi, it provides 
a sturdy, collapsible system for the mounting and adjusting of a 
wide variety of cameras and camcorders. The new base designs 
used on the Magnums are a refinement of our earlier bases, 
with the QPX-1 having a fixed base and the QPX-2 having a new 
low-proTiie micro-tilt adjustment stage. The easily adjustable 
click-stops will let you capture a panorama in a few seconds. 

The QPU-2 has two accessories, a Landscape Bracket for 
positioning the camera in the landscape orientation (QPLB-1) 
and a Counterweighling Kit (QPCW-1) used to balance large 
cameras or camcorders, such as the Sony VX-1000, that have a 
center of mass well behind the pivot axis. 

QuickPan Magnum-1 (HQPMAGl) Our Price $499 
QuickPan Ma9num-2 (UQPMAG2) Our Price $549 


QuickPan Magnum Accessories 


Counterweighting Kit 

The Cbunteniveighting Kit includes a weight and adjustable arm 
that is used to offset the weight of large, heavy cameras and 
camcorders. 

(HWHTKT) 0urPrice$129 

Detent Wheel 

Detent Wheel (5-inch) (Color = Purple): 10,14,18.24 and 30 
Position {QPDD-2) 

(HQDWHLS) Our Price $49 

QuIckTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2. that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of 
QTVR/VR nodes In a short period of time. 

(HQTLVLR) Our Price $149 
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KiWi 

by Kaidan 
Tbe KiWiTM 
is the most 
affordable 
VR/QTVR panhead, 
bringing digital 
photographic panoramas 
to an even wider audience, it's the 
perfect companion to programs such as 
QuickTime VR Authoring Studio, PhotoVista and Nodester, providing 
a complete solution tor anyone interested in adding VR panos to 
their websites and multimedia applications. 

The KiWi'“ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple QuickTake 100/150/200, Kodak 
DC50/120, APS film cameras and 3Smm SLRs equipped with wide- 
angle lenses. KiWi^^ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 

(HKfWI) Our Price $99 



by Kaidan 

The KiWi-i- adds a compact, yet durable click-stop mechanism ! 
and the same twin-axis bubble level tound on the top-of-the-line 
OuickPan Magnum Series beads. The twin-axis bubble level 
(recommended by Apple and VR professionals) provides a clear ; 
indication of level, even when the unit is slightly above eye level. | 
The click-stop mechanism uses easily replaceable detent discs, 
which are available in a number of positions (8,12,16,18,20). 

The KiWi+ ships with one disc of your choice and extra discs are 
available separately or as a set. The click-stops speed the r; 

process of shooting a panorama by eliminating the need for the 1 
photographer to look at the unit in order to visually align the 
index increment. 

(HKIWIP) Our Price $249 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-i- and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time. 

(HQTLVLR) 0urPrice$149 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parts required to turn your KiWi into a 
KiWi+ — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12,16,18 or 20 positians). 
(HKIWIUP) Our Price $199 

KiWi+ Detent Discs 

KiWi-t- Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HOTDISC) Our Price $24.95 each 

(HOTDISC4) Our Price $89 set of four 

Choices include: 8,12,16,18, or 20 position detent disc 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWi or KjWi+ upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAQ Our Price $42 

Flash Hotshoe Level 

A dual-axis bubble level hiat slides into your camera's hotshoe. it's a 
useful tool to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset Spacer is a circular spacer that may be required for 
very narrow cameras (i.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot axis. 

(HOFFSPAC) Our Price $24.95 
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Be Studio 

by BeatWare 

Developed specifically for ttie 
BeOS, Be Studio is tfie first 
graphics application to offer 
full multithreading for 
unbelievable responsiveness 
and unbeatable speed. Be 
Studio includes Paint tor 
editing photos or creating 
original artwork and Draw, a 
vector-based tool tor 
drawing crisp designs and prints. Be Studio offers the BeOS 
developer the ability to; 

• Design application icons guickly and easily 

• Edit and export images easily to the World Wide Web 

• Manipulate several images at once without degrading performance 

• View updates from a variety of perspectives simultaneously 

• Import and Export images as GIF. JPEG, PNG. TIFF and PNM files 

• Plug-in third party tools and filters 

Be Studio requires the BeOS, 16 MB of RAM {32 recommended), 
3MB available hard disk space and a 256-color display adapter. 
Price Includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBESTUD) Our Price $99 
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webAlias 1.0 

by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 

single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias' anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129 
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Music Tiracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musicat 
introductions, fanfares, background music, 
and more. This collection offem you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Plus or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24.95 


MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music CD- 
ROM for the Macintosh. This disc is a collection 
of clips ideal fa Desktop Presentations and 
other Multimedia applications. This incredible collection of license-free 
media cfips is bursting with 240+ color pictures and backdrops PCT), 
200+ sound & music clips (SoundEdit), 140+ QuickTime movies, and a 
variety of multimedia tools for use with the Macintosh. 

(SMWMC) Our Price $24.95 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring tool and on¬ 
line documentation system for the 
Macintosh and World Wide Web. 

HyperGuide provides integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and 

shape fills, most QuickTime-supported image formats, anti-aliased text 
and QuickTime VR movies. HyperGuide also includes an Integrated 
screen capture utility and user-configurable slide show mode. 
(SHYPGUD) OurPrice$149 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

AudioTrack SAUDIOTRK $270.00 

Captivate 4.6 Essential Graphics Utilities SCAPTIV $79.00 

Media Cleaner Pro SMCPUP $359.00 
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PowerSD 

by Techworks 

■Rie power of an arcade on your 
PowerPC Based on award winning 
3Dfx VooDoo Graphics. The PowerSD 
works with your existing graphics 
card and multi-sync monitor to provide you the absolute in 30 
performance. Install the PowerSO in your PowerPC (requires one 
available PCI slot in your system) and use the provided pass-through 
cable to turn your PowerPC into a Power Arcade system! 

Power3D comes bundled with these awesome 30 enabled games: 

• Quake*: Episode 1 (8 level) by Id Software 

• MechWarrior* 2 by Activision 

• VR Soccer " by VR Sports (Actua* for Europe) 

• Weekend Warrior" by Bungie 
(SPWR30) Our Price $249 



Abuse is 360 degrees of side-scrolling action. 
Run. junop, fall and fly in any direction - through 
industrial corridors, caverns and sewers. Destroy 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo txxstl 
Key Features: 

• Point and Kill Intedace. Move and annihilate mutant in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 


Abuse 

by Bungie Software 


1000 Games for 
Macintosh 

by BeachWane, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 



^ Myth The Fallen Lords 

* by Bungie Software 

PC GAMES MAGAZm’S, Most Anticipated 
New Game Award 

The Fallen Lords is a fully 3D real-time strategy 
game of epic battle. A multimetric game. Myth: 
The Fallen Lords gives gamers unprecedented 
freedom to view their forces, orbiting around 
the heads ot a formation or zooming in for a 
close-up on savage melee. Myth: The Fallen Lords includes maps 
designed for networking, and alternate networking scenarios like 
Assassin and King of the Hill. 

(SMYTH) Our Price $49 



Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
with killer graphics and sounds! Walk Uirough a 
virtual arcade and test your game playing skills 
with these exciting arcade classics. Ten games, 
inciuding Moon Lander. Astro-Boing, Hyper 
Hockey, Ballistic Avenger, and more. System Requirements: Mac — Color 
Mac with 8 MB RAM, CD-ROM drive. PC 486 with 8 MB RAM, Sound 
card, SuperVGA, CD-ROM drive. 

(SOLA) Our Price $24 



Marathon Ik'ilogy Box Set 

by Bungie Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you'll also 
receive a staggering 1200 maps, featuring never- 
released Bungie maps and the winnm of the Infinity 
Mapmaking Contest, The Marathon Scrapbook (a behind-the-scenes look at 
themaking of the Marathon games), Marathon collectables like the Marathon 
3-sticker set, and to top it off, the award-winning game that laid the 
groundwork for Marathon: Bungle's breakthrough Pathways Into Darkness. 
The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh, CD-ROM drive, 8-bit color monitcx 
(13“ recommended), and System 7 or later. 

(SMTBS) Our Price $^ 



WAIT- 

The«^ 

More 


Here are more products. For full product descriptions please see our 
/S site, or feel free to call, fax, or E-mail us. 

ie/ PRODUCT 

CODE 

OUR PRICE 

M A Zillion Sounds 

SAZS 

$24.00 

Casino! 

SCAS 

$24.00 

Night Sky Interactive 

SNSI 

$24.00 

Trivia Warehouse 2000 

STW2K 

$24.00 


Web site: hftp://www.devdepot.com • E-mail: orders@devdepot.com 
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metrowerks 


GeekWare"* 

You live it, you breath it... you 
might as well wear it! (XL only) 



Alien T-Shirt 

(AALIEN) Our Price $9.95 
Amald T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS) 

{ACWSBLOOD) Our Price $9.95 

Biood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOD) Our Price $14.95 

CodeWarrior Basebali Cap - Biack 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Biack 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Fhre-O Shirt 

(ACWHAWAII) Our Price $9.95 

CodeWarrior Winter Hat 

{AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(ADBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADISCPTI Our Price $9.95 




Now you can have laptop stability, drop 
protection & mobility. It you’re looking 
for an inexpensive, non-technical gift 
for a laptop owner - took no furttier. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all legs (13“-46") 

• Velcro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 

• Dropped laptops account for 41% of ail laptop fatalities 

• Manufacturer’s lifetime warranty. 


Podeum Sport 

by Rach, Inc. 


(APODSP) Our Price $39 



MacTech® Mouse Pad 

Slide on thisi With an extra-large surface (1 r by 10") and 
a deluxe sleek plastic coaling, you'll be zooming across 
your screen in no time at all. Speed limit not enforced! 

(AMTPAD) Our Price $8.95 
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For Madntosh 
Pro^rflmwiprs & Devehpers 



MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody, Java, 
QuickTime, OPENSTTP, Objective-C, C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 Issues $97 

Back Issues: each plus shipping (subject to avaiiabitity) $10 




MacTech® CD-ROM Volumes 1-12 

• Includes Apple's issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, Improved Indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hypedinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference— the original online guide to Inside Macintosh, Vote, l-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• Sprockef^l MacTech’s tiny framework that complies quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTC012) Volumes M2 Our Price $129 
(SMTC012U) Upgrade from any previous version Our Price $49 



Inside Macintosh: CD-ROM 


by Apple Computer, Inc. 

More than 25 volumes in electronic form, Includes: 
QuickDraw”^ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox 
Essentials and More Macintosh Toolbox, QuickTime and 
QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross 
referencing. 

PMCD) Our Price $89 



Order Toll-free 
800-MACDEV-1 


fffi)04?2-338l| 



Web site: http://www.devdepot.com 


E-mail: orders@devdepot.com 
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New Books! 
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The Official 
BBEdit 
Book % 


The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

Tbe Official BBEdit Book makes it easy for 
today's Webmasters to speed tbeir own 
Interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like ftoating palettes, 
HTML support, and syntax coloring to 


enhance an already extensive feature set, making BBEdit a ieading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilities, and 
support for 13 languages make it easy to see why so many Web 
developers use BBEdit as fiieir primary authoring tool. 

(BOFBB) Our Price $35 


Effective C++, 

Second Edition: 

50 Specific Ways to Improve Your 
Programs and Designs 
by Scott Meyers 

Effective C-m-, 2nd Edition includes: Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard C++ library, including how the 
Standard Template Library and classes like string and vector affect 
the structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C++ continues to be essential reading for every 
developer working with C++. 

(BEFFC) Our Price $34 


DeBabelizer 

by Lise Oespres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
official guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

• Create graphics and Images for the Web that download fast and 
look amazing 

• Optimize graphics for CD-ROM, video, and animation 

• Optimize and manage colors using the SuperPalettefTM) 

• Discover DeBabelizer tips and advice from industry experts 

• Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $40 


DeBabeuzeh 



i- 



Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools, 
(BSYMSOUR) Our Price $35 

Web Security Sourcebook 

by Aviel D. Rubin, Daniel Geer and Marcus 
J. Ranum 

Technical tools and techniques for 
building secure web sites and 
applications 

This book shows web masters, web 
managers, and web designers the hands on 
programming techniques necessary to build secure web sites. 
Readers will learn how to secure the server, use firewalls and 
cryptography, write secure Java applets and CG! scripts and more. 
Companion Web Site includes source code examples plus updates 
on the latest security threats and techniques. 

(BWEBSER) Our Price $26.99 

Buiiding An Extranet: 
Connect Your intranet With 
Vendors And Customers 

by Julie Bort and Bradley Felix 

Building an Extranet will help companies use 
their Intranet capabilities to supply information 
to selected customers and vendors through a 
secure Extranet. This book provides complete information and working 
details for building the network behind Intranets and Extranets, 
designing the applications, and getting everything up and oinning. 
(BBLDEXl) Our Price $26.99 


The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider's view of the 
Java^“ technology by posing 
and answering the most important, frequently 
asked questions about the Java programming 
language, Java applets, and Java stand-alone 
applications. The Java FAQ is unique in that it 
draws from the tens of thousands of quesbons sent to 
<java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $25.13 


The Java* 
FAQ 
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APPLE ENTERPRISE SOFTWARE 


Getting Started With WebObjects 

by Apple Enterprise Software 

If you're a first time user, start here to leam the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into fire request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OPENSTEP objects available on Windows 
through OLE. 

(BDOLEDGj Our Price $22 

Discovering OPENSTEP, Mach 

by Apple Enterprise Software 



Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
0bjectiv8-C is easy to leam and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ Interface Builder (for eof) 

by Apple Entei^rise Software 

A hands-(Mi, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 


Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. /Ui 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 


Using EOF 2.1 w/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 


Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 


The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of pragramming tips and techniques. 
An appendix offers a summary of Ertfitv-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 (BE0FDG20) Our Price $24 
EOF Developer's Guide for EOF 1 .x (BE0FDG1X) Our Price $24 



Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 
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Rhapsody Developer’s 
Guide 

by Jesse Feiler 

Covers the basic architectural principles 
of Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
eiements of a modem OS such as 
preemptive muititasking. protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to deveiop Rhapsody 
products. Paperback, 450 pages. 

(BRDG) 0urPrtce$35 



th«rway 


The Way Computer 
Graphics Works 

by Olin Lathrop 


computer 
^graphics I 
works 


A compiete guide to mastering 
computer graphic basics. It is written 
in a trank, down-to-earth style 
covering everything from how 
computer graphics are different from 
tine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resoding to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 


f' 



Debugging Macintosh 
Software 
with MacsBug 




KOHliTATiTIN OTlIMFlt 
JIM SI It Alts 


by Konstantin Othmer and 
Jim Straus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program for the Macintosh. Ttiis 
' booK/disk package is an ail-in-one kit 
for using MacsBug. Chapter ^ introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31 


Order Toll-free 
800-MACDEV-1 


18006223381 ! 


Check out our Web site! 

• Full product descriptions ■ Hundreds of more products 

http://www.devdepoLGom 


Practical Ob[ect- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 
This book offers advice on real-wodd 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design. C++, and Java in a way that makes these potentially 
daunting operations more accessible than they've ever been before. 
(BPOOD) Our Price $31 



WebMaster in a Nutshell, Deluxe Edition 

by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CO-ROM contains the Web 
Developer’s Library—the full text of the latest editions of five 
popular O'Reilly titles: "HTML: The Definitive Guide, 2nd Edition"; 
“JavaScript: The Definitive Guide, 2nd Edition"; "CGI Programming 
on the World Wide Web”; "Programming Perl, 2nd Edition"; and 
"WebMaster in a Nutshell." The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell," the all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 

Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNDTD) Our Price $62 




IS 


Designing 3D 
Graphics 

by Josh White 

In this powerlul book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to Imow to 
create sophisticated real-time 3D 
graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and 
hands-on modeling techniques that Josh While has learned while 
creating artwork for over 20 commercial games, including Descent, 
Zone Raicters. Locus, Legoland, and others. 

(BD3DG) Our Price $35 
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Inclvfles 

Disks 


Wireless for the 

IwTTlVIl 


Wireless For 
The Newton 

by Julie McKeehan and Neil Rhodes 

A book ttiat picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enciosed fioppy disk provides a sampie 
appiication, as weii as a fully functional 
demonstration version of Nevrton ToolWt. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31 


JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to show you how to 
turn Netscape into your 



>W1ZARPRY 





own personal, 
customized operating 
system. Provides the 
inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous interactive scripts written in JavaScript you can add to 
your Web pages today. A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31 


JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 





Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
aK)lications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet 
Explorer 3.0, and LiveWire. Includes CD-ROM with Sun’s Java 
Developer’s Kit, JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSDG) Our Price $44 


Web site: http://www.devdepot.com • 



Linux Configuration 
& Installation, 

3rd Edition 



by Patrick Volkering, Kevin Reichard, and 
Eric F. Johnson 

Linux, the leading UNIX variant, 
has garnered loads of attention ' 

within the UNIX community. The 
amazing thing about Linux is that you don’t need a 
workstation to run it. Linux Configuration & Installation, 

Second Edition lets you run Linux today. Program with Linux using C, 
C-i-t-, Perl, and Tcl/Tk. The 2 CD-ROM pack offers one of the most 
popular Linux distributions, Slackware 96, and comes directly from 
Patrick Volkering, the creator of Slackware. 


ly 


{BLCI2) Our Price $35 


Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially tor entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $22.45 



HTML Sourcebook, 3rd 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML Sourcebook 
is the best guide to HTML for Web 
professionals. That’s because no other book 
makes it so easy for you to quickly master 
all the commands, tools, and expert 
techniques you need to create cutting-edge 
Web page documents, Completely revised and expanded by nearly 
50 percent, this new third edition of the best-selling guide to HTML 
gives you the complete lowdown on all the changes and 
enhancements to tiie HTML, HTTP, and URL standards, 

(BHTMLS) Our Price $26.95 


Teach Yoursetf Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and tine concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only book that takes you 
step-by-step through real projects 
designed by talented new media 
artists, Internet design experts share 
their design secrets and art files (look 
for art files on the companion CD-ROM 
by artist’s last name). This expanded new edition includes 
Photoshop, Illustrator and DeBabelizer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $35 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion, Just a few of the topics 
you’ll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts, With this book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 




; OPTIMIZING 

optimizing PowerPC Code: 
Programming the PowerPC ' 

Kaclmtotli Prijj^rjinirn T't 

TOOL 

BOXf 

CDDlv 

in Assembly Language 

by Gary Kacmarcik i 


Take full advantage of the potential of the 


PowerPC by mastering the Assembly 

Language techniques. Learn to produce 




(i'r^ 


(BOPTPPC) Our Price $35 


HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 
Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You’ll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 


Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web, This 

__ _ hands-on reference makes it easy to 

g ’ create Shockwave movies and put 

them on the Web. Expert tips from the 
creators of Macromedia's first 

Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 



Programmer's Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 


JavaScript For Tbe 
World Wide Web 

byTedGesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJM/WW) Our Price $16.15 
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Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



Includes CodeWarrior Lite, and Full Coverage of PowerPlanf''^. The 
best information on Metrowerks CodeWarrior, giving full coverage to 
the Gold Edition. CD includes CodeWarrior Lite. 

(BCWPROG) Our Price $35 


CodeWarrior Software 
Deveiopment Using PowerPlant 

by Jan L. Harrington 

C++ programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using tfie PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CO-ROM contains source code for all the programming 
examples In the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31 



Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant, 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY: Dev. Environment 


Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.com 




C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 


(BCPPCW) Our Price $33 




Learn C on The 


Macintosh, Second 
Edition 

by Dave Mark 


New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file input and output and more! Includes CD-ROM with 
Metrowerks CodeWarrior’'^ Lite. 


(BLEARNC2) Our Price $33 


Order TolMree 


800.MACDEV.1 

(800622-338II 


MacToch® Magazino 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody, Java, 
QuickTime, OPENSTEP, Objective-C, C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues; each plus shipping (subject to availability) $10 



Web site: http://www.devdepot.com 


• E-mail: orders@devdepot.com 
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AppleScript Language Guide 


by Apple Computer, Inc. 

A complete reference tor anyone using AppleScript to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in the following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects, 
includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script vanables and properties declared at 
different levels in a script, and inheritance and delegation among script objeots. 

(BALG) Our Price $26.95 
SEE REUTED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O’Hara 



Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac-Like", Uses a step-by-step approach 
to demonstrate techniques for building 
applications through Illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1,1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price 


Compkie 

l^reiEna; 


l^NG 

CGI 


Special Edition 
Using CGI, 

2nd Edition **ro^ 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 


Second pue 


This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 

on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGi) Our Price $44 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, witt 
having to understand C or C++. CD-ROM 
contains “Wiziets" that allows you to easily 
create your own JavaScripts, Takes you step-tiy-step through 
programming cross-platform JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 

(BJAVASCRPTJ) Our Price $40 




Java in a Nutsheli, 2ncl 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1,1, both on a package-by-package 
basis and in terms ot overall functionality. A 
comprehensive tutoriat on "inner classes" 
that explains how to use all of the new types 
of inner olasses: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean, 

{BJNUT2) Our Price $17.95 



AppleScript Finder Guid^ English Dialect 

by Apple Computer, inc. 

Provides definitions tor Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY; Scripting 

Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User’s Guide. This is the printed version of the 
documentation provided on toe CD, Covers CodeWarrior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 30 graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system Itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGRAP) Our Price $35 
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Ik'icks of The 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celestin, et al. 

for beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, CodeWarrior'''^ l-ite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Glypha III was created. Hundreds of tried-and-true 
tricks, tips, and insider secrets from well-known Mac game 
programming experts, 

(BTRICKS) Our Price $45 


Advanced Coior Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX, Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and inpirt/output devices (scanners & 
printers). CD includes a complete reference information in botti 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33 


1^ Black Art of Macintosh 


ms OF If ■ 

} 


-V Bilik Attof \ 

macintosh' 
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Game Programming 

by Kevin Tieskoetter . . 

Develop your own 3D games in 
C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code—all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35 



Here are more products. For full product descriptions please see our 

There » 

Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 
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..17,95 

fywipiiilfc htaivtifii* . _ _ 


. BtWUW. 

. _444444jjS 

Dannv (kioclintei'sAtoto 6tiidi;i Starler Kil. 


..HXJA4jSK .. 

.31.00 

Daniv tiooilAan's .. 4,.,..- 


.BGOOOHe. 

2&9B 

fiaiiteWivtcsSauns Cotto 1^..r-,-,^-iii- 


.HIKWSC .. 

.895 

Hramnwvlc.': btAna.. 


.444.....M1FWBACK 444. 

..6.00 

Graphic Gems 2.. . 


...BGtMS2. 

...-4400 

r/Bpliir finma 4 . .. . 


44-4.4.. . ..BGews*. 

.44.D0 

Tiftiphlr . 


. BGOVtSS . 

_...44,00 

|n11fM-|1 Hpu<V>kBl , ., ,,,, ,, ,. 


. aMFone^ 

.40,00 

Insldfl Dlroclor 5 willi l.irigrt (or Macirflo^... 4...,..,.. 


.BD5WLM,, ..44,« 

_,,.44.00 

Ute Nighi ttilh Madiack ...,44^1..44.444-_____ 


..eUTF.. 


Mac BstfMpoih fleartar.. 4.4....44...... 


. Bami . 

11.70 

Macrnmixisi f^iredor Lhgp Worltshop. 2hd Edrtiai . ...... . 


.. ,.44 . BMBW? . 

4800 

Mac Scrcanet: The Uthnraie WfetoMTtosn Sttoordwiijnriij Kli. 


.BSCRTAM. 

. 31.00 

Maciiktuah CraBh C(Mjrsa.._..... 


. BOWSH, . 

.2895 

Mn'iTratli Rftrii Lvaim... 


. MTOACWSS 

.. 10 00 

Marwtoil iMrnate Manrrtosh P*ogr?pr™^ ftnpic .„.,,,,. 


,.BILTMAC... 

_35J» 

MADACnN ‘93 CD-BDM . . .....4...,44^.4.44-4- 


SMADAS^. 

- .895 

MuiitiiMito Authoring. tJulWtog and Dockjfur^ Documents - 


.BMMNjm. 

. 31.00 

Murtittifidia Starter Kll tor MackilEih. ... 


44.,„.4. nMMSTAnT .. 

.. 27.00 

fttifii tiom F xpHTieflce ... . ... 


• E^^TEniTr 

.-jajs 



. BnESHffi . 

. 31,00 

Uar^ jmn r _ 


iKAnuai; 

_ 22,45 

Stsoriartls for Onfins CammtimuiilNjn ... 


. „ . BSFOC . 

. 4800 

The Ctemertts. of E-Mail Style. .... 


... 4,..BT^...,. .. 

. 13,45 

The Scfttware UewlopGr's & UjirkutiM;^ Lngal Gomoariiori .... 

. 

..—.UajAMLC - 

33.00 

Tog on SoUware Resign _ , _ ,,^,^--.,-^-.,,.1 _ _ 


. ..biog. 

.26,95 

Tiicfani the Mac Gamn GuriLi. .. 


RiaCK-*; 

......4S.Q0 

Zen and toe Art of FfcsuiMtM editing . . ... 


_^..-. BiAAORE ... 

...4.-27.00 
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All entries in this Index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh.._ 

.19 

■ 


2D Gnupt^ Ptngramming LJ^ng Qidf/lmw 3D......... 

—,,....27 

BUecttve C-F+, Second Hftfcn.,—..... 

. ,„22 



B 3 FD 3 M 9 fcper!s Guide kx EOF2.1 {Mach 8144hctowsrj,,,„...... 

q\A 3 x Producticiins.......... 

__ 

.,15 

At« 50 ft D^rporation........ 

Abuse.. n.mi.TM. ... — 

..4 

_19 

Excel Software...... —..... 

.7 

Adanation....... . .. 

...9 

■ 


Arlrlitinn:il 1 bcKngs fnr Dpwlf^fvnpnt Fnvimnmont*; ... . 

ti 

PaceSpan v2.1. ... ... . 

.......,,14 

Addtiionel List^gs for Games...... .r , .n.,.,..,. 

_19 

v2l SRT.. 

..14 

Additional Listings for Internet.,.,._.. - 

_13 

FutffTP II,......... .. . Iiipnirn.“ 

« — ,6 

Additional Listings for Multimedia.. , m i., , .ir.ii.i.nii.imni 

_18 




__ 11 



Adtenta Inc,..,..... 




AdvMnnfri Crinr tnaghq pn tfw Mar OR ,..___ 

.,27 

fWkWflW.«- . 


AG AlJthcir ..,, .....r- -TTT^iTiTtrmiTTtnTm - 

_ ^,„10 

Gating H^The Qi^de To PrOfTXT^ng )dur Wsbs^ . ... 

__ 26 

Aihra Software, Sic........ 

.fj 

Getting Started Wkh WebOtjetXs ........ 

.23 

Appfe Bii&pfise Software ...... .... 

__ 23 

Guide Orwnpnsfw^'* 1 .?.- —-.. . 

p —*.8 

ApfjleScript Appkations: Bunding Apps w FaceSpan/App^j^. ... 

. 26 



AppleScript Finder Gi£d£t, Engksh Diafecit ........ 

. 26 



AppleScript Language GukJs ....... 

..26 




_,9 

/™l For 7 ?b ItoWVWtte 2ndBmxi —...... 



_„-7 

HTML Sot^C^rooK 3rd Edi^.................. ....... 

. 2 fj 


-_15 


-12, IS 


-B- 


B-Tree HELPER 22 ......—J 

Barfl Bones Software.............8.10, 12 

BBEdit 4,5„___—.....12 

Be Basics——______-___—_ B 

Be. Inc. ..................3 


Be ______^18 

BeadWre. Inc,..........10* 15* 18,19 

BBHtVto..............S. 18 

BeSpeciHc 3______-....... _9 

8 (ac#f M Of Madniosti Game f^pgrammiTg.................27 

Bowers Devetopment.............,...9 

BuSdhg An Extranet: Connea >fctr intranet w ¥Bnckxs/Custon^ ... —22 

Bongie Software............... ...19 


C+4 AtJgammirjj; mf/j CodeWamor. .*.*..... 27 

Captivate 4.6 Essential Graphics Utilities —--IS 


Cetestin Company 

COiToeitit.^_ 

Classic Arcade... 

Clip VR^.. 

CodeBciilder 


....J 

-13 

...19 

„.15 

. 5,8 


CodeWarhor Discover Programming Editio—... ..... ...3 

GodeWamoi' for BeOG 3 ... ■■■■■■■■■■■■. 

CodeWarrkir for PaJmPilot____ ^ 


CodeWanior Latitude 


CodeWamor Professional Release 2,........^^^, __ 

OodsVI^TOr Software Using PowerPiant ...— 

Gonlx Graphics... ................ 

M— 

__27 

.....11 

D'OLF Dei\/eloper's QiJde. ....... 

.. 23 

OfififflhfifcHT_________.. 

. . 22 

DeOuggiirjg Madntosh SbftVwJre wflri MacsBug.. ... 

. 24 

Dosigrnrig 3D Grs^Ncs.,. ...—.. 

24 

Digital Technoiogy Irftemaiional__—.....,....,.. 

. .„14 

Digtool, Inc,________ 

......3 

nisfXM>nng (iPRs^lTP, . . 

.. „...23 

Discx/rering OREh/STBF^ Windbws,,,—.,,... 

DynnMrwph IJi.... .....^-.riTTTTrTiTTmT- 

__ ...23 

.. 14 

Web site: http://www.devdepot. 

com • 


^ncrei^iTg ms ancf Seihg Wbreon yw Sfte....—....25 

tmie COd^rt^mbf Pm^ssionat. ..........„.. 2 e 

hsicteMaohfosh. CD-ROM.. ..........„2f 

tnskie PnwfuPtant ............„....27 


Java Ina Aftjfshef, anOfiSfcn ....... 

JawaSoflDt 7.1 Osv 0 (qpar'sGtJde..„...—....-....25 

JOt^SGr ¥37 kx mMapnkJsh..., ....... „.26 

Jav^cript & Netscape Wizmky ............25 

JEawjScr^Tbr 7?ie WM Wide ...........26 


—K— 


Kadan...________... 

KiWi______ 

KiWi and KjWj+ Accessories__ 

KjWi+ E>etent Discs--- 

KiWi Flash Hotshoe Level...-.....— 

KiWi Landscape Bfackel-..,».. 

KiWi QuichTilt Leveler........— 

KiWht]CHKiWi+ Upgrade... 


... 16-17 

. 17 

... 

..-17 

__17 

__ 17 

.. -.17 


Lakewrood SaftwarH..—™»..-,.«*..,.—....10,12. IS 

Late NjgH Software Ud ....14 

Leam Con The ModntoshSecondBStion .............,27 

Unm Conk^/iBUon & tn^sMon, __________25 

MacA&D 6^0,*.... ———7 



MacA&D 6.0...___...------—_____7 

Macintosh Common U$p 4.-.—, 3 

Macromedia SftocJkwave Pot Dtector.... ....,..26 

/Ifecrecfi® CO-fiOW ^Ujmes f-72...........27 

A4ac7ecri0 Magasrte. .......,,..27, 27 

MacTech© Mouse Pad ----- 

Magellan Accessories 

Magellan QC.. .... . —.. 

Magellan QG Detent Wheels.... ..16 
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Magellan QC Pedestal Set,. 

Magreaabte Soltwa^...... 

Main Event Software..... 


.J6 

....e 

.J4 


Mango Tree Kfiftware ............. ... 


.„14 

Marathon Trilogy Box . 


in 

Maxiin DeuBkapment.....- 


.13 

MfVtlA dftanar Pm muimnnriToniTi.. 


. 



.. .fi 

Metroworks...... 


..2* 3, 20 

MSsftDWBnks CodeWb/TOf RpQranwiiTg---,-^^ .. 


..,_27 

MkLir^iiv" Uirankf^rvil Lkiuii fnr PtfliUlAf 


...4 

fWInWiiMA.. twwn^ vfSVT1 K?l UilUA IWf WW? rvwtt maiMttti 

M^vpii_,,_^____ _ __ _ 


. Id 



.If* 



1ft 

MW IT^tial SourceSafe Release 5_ 


.. ,-..2 


Myth The Fallen Lords . 


..19 


Msus Software., 
Neon Software.. 
Music Tracks,.. 


NetMfr>der Ethernet.*. 


..... 10 

_—_____ 18 

_____ «6 


Script Debugger ............14 

ScriptDefnon„,^,.,~.......«««,««_........................----6 

Scripter ZO „—-------—-----*««14 

Seapine Software. Inc. ..... ............... .9 

SmaKTalkAgefvts for Macintosh ____________ 

Smatcocte Software....—......— ..6.12 

SeftP^rfish CD-nOM___ ^...10 

Sophisticated Qrcuits............. -------6 

S^xda/Edmn Using CGf, ___________ 

%>otI|ght........ , ........7 

SHaz Software ...—..............6 

Step-Up In&taHer Pack.™________—- 

SiepMP Software..—.............8 

SlooeTableeSK/PfK:™.™__*--7 

SUxieTabtet PUbtehing .......—...7 

SuperPloft.........—10 

SuperPfotPRO....——---tO 

SupaSoft. 10 

Symantec Vfeuaf SoorDsboolf..............,..22 


NS BASIC CorporatiDn.. 


Ot^ecf-OiarTted Programming and C,.. 



_____ 23 

ObfOCiMastef' Professional Edition 




DhjftrtSut Mbiil RnK . 



..ft, IP 

Offset Spacer__ 



__17 


Onyx Technology. Inc. 


TCP/IP Scripting Adcilion --- 

Taach \ttjrs^Java tor Macintosh in 21 Days....... 

Techwoiks.............. 

Tenon Intersystems.... 

Terran Interactive —.. 

TestTreck-Bug Tracking the Macintosh 

The Java ........ 

The Office 6BB£t Book ....... 

The lA^y Oorjvxrier Ogphfcs Mtodcs.... 


. 25 

___19 

.,.5. 8.12.13 

.15 

-- 


... 22 

..^ 

......„.....24 


OMfniahg Cocte: Ri^grjjrm^ 

..„26 

Tricks o77he Mac Game Rogramming Gun/$ ...— 

.27 

1 -p- _ 

PageCtiarmer 1.0.-■nri-|-n:ri,_ itthtf—T-T rT— t— n.... ■ ' 

_^.„12 

UNI SOFTWARE FTJJS.......... 

.....,7 

FVlori.js he. ......... 

__.13 

UskigEOFZl v%70FeVS7BP (Mbch & WhdowsJ...,... 

.........-,23 

Pibt Attach^ Disk 1-....—______ 

_ ,S 



Podeum ■ 




Power MachTen 4.0.3.....— 

,.™-,13 



PowerSD.........._ _ .. _ 

........ 19 

Uip-nacur- Viotial Infersu^tiuA Pingramimtng tn FU<%ir: 

d 

PowerKey Pro Model 600, 200 —-. 

..._..„6 

V1P-jC; Visual Interactive Programming in C 


Ract/cai OtjjbCf-TThwTfiflrf Dfavnlqpmi^f h 0++ andda>ra . 

. . . 24 


__ . IS 


.*..,..,*14 

Visual MacStandadBasic 3.0. „. 

.7 

PreFab Snftware, Inn. ... .. 

.14 

VMsta . ....—. 

....11 

PrimfiTtitie FfHewarie..... 

....4 

VOODOO 1^ .... lu n n 1 1 . 

.7 


__4 

VTflvt . .. . 

. -...11 

Programmer's TootoxAssistanfCD-POM.... ...... 

_ 26 




QC ........7 

Quasar Knowtedgo Systems, Inc...............4 

QUED/M 3.0....................10 

QuickPan Couiterweighting Krt...,--—--16 

QuickPan Detent Wheel.... .. _ , , .. .16 

QuickPan Magnum—....—.. , ■ ..—16 

OirickPan ll^agnum Accessori^-_____16 

QuickPan QuickTIit Leveter...........«...16 


Rach, kic..................20 

Riapsod/ D&retopGf's -----— ..24 

Roaster Tedrtdogfes. Inc. ........—&, 13 

Ro^ Software, he............6> 14 

Rumpus....,..™..... I ...13 




—W- 


V^er^ Edge Software..—---------....9 

WAVES.................15 

14^ Pubksher's Design Gticie ibr Madnto^, 2nd EcHthn ....26 

Web Security Sooroebor^^ — ............ 22 

Web Ware_*_*________10 

webAias IjO......-__....12,16 

WdbM^^^rlaNutshB§, Dekixs Etfion........ 24 

WfebO^isete Osvefcper^ Gyda„.....— .... .25 

Vlfliefess For The Mavi^cyi........... 25 

Wbfkhg w/ kiiarfaoB aibar ftbrEOT^ ......— .... 23 


Xplairv Corporation. 


.-20,21, 27 


-Z- 


zeuve Software. 


__7 
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H 1 T]w mcisrm wc call Installemater 4 J the 
Hy Ctimplete [ni^tallation Solution is becaLiKe 
1 ^ we include nV(*ntllin|j VIJK JlPPd to prepare a Ira 
professional package of files for itistallal km on your'w| 
users' machines. An insUller, updati^r, and an 
uninstaller are just iliree tximponente included for the 
^ same price one of our fine competitors charges for 
||^\ just the installer. And weVe Just added ^ 

electronic transactions^ ShrinkWrap, and 
K/ improved internet configuration siippr^rt. jB 
B Using our installer reduces technical support 
^ calls due to en<l-user errors during installation, * 
saves disks (if (listrihuting on floppies) or download 
time (If distribuimg ondine). And the puzzle will be 
solved. You’ll have evei^ piece in place, 

Dovmload a ffPC, fully-Fii netiona! copy of 
InstallerMaker 4.1 from www.aladdinsys.com, or 
j (rail {408} 7fi 1-6200 and ask for Developer Sales* ^ 


© 199/ AJartcljn Syatorrs. 166 Wessidpe Dtive, Wateyriviite. CA 950/6 Fax 

imomei: fJovs^te^Oaldddirie^ AOL, ALADtMW. StirWir inr^rfiUft^M^K^r 13 a irademark 

ol Aiacichn Syalertis. jnc OlliCf are tradetniarkij ol ttwif fTiifXKriw© hoWefs 


Aladelin 


• Install qr 


UNiNarxiLL 


* Resdurce 
INSTALUATION 


• FULL 


• Shrinkwrap 



















■»-'■'s ~m. 


'tf^' ^ ^ 




Ri^apaody gets here, 

? '/iV4 ’ll'’bB ready...with 

X* ^tS^'MJb^eWarrior I,atltude“ 

w %.ra-s- - _ > 

r^ “"'I-tr^s Matrowarks* newest 
f i % 1 '*% porting tool, designed to 

I 2j,, 

’ ■ f - igi'/a you a lag up on 

Rhapsody. Reaoinplle your 
'Jiao' OS souroe coda, link it 
> : . with the I,atltuda libraries 

and find out which portions 

''itr ' ’ . 

of your 00da ara^ going to 

■r* -ft,/' _ 4'—^ 

' port smoothly... and which 
. won't is fore- 

^ ^L,. armed]. As Rhapsody evolves, 
f-■ ■ so will E,atltude; registered 
users will receive all 
dev^ 1 op a r releases, the 
j' A ! first full release, plus 

! i 

V Krv(-- :pon ^-additional update, 

[.J * ■■• >'»»: ■' ' ' _ 

I I i'io'daWarrlor latitude. $399. 

H & ‘The tools you need...and 
' ' little attitude to boot. 


©1997 Metrowerks Corporatfon. All rights reserved. 





















